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DECLARATION UNDER 37 CFR 1.131 

Sir : 

We, the undersigned, Samuel Kallner, Lev Kozakov, Alexey 
Roytman, Uri Shani, and Pnina Vortman, hereby decl.are as 
follows : 

1) We are the Applicants in the patent application 
identified above, and are the inventors of the subject matter 
described and claimed in claims 1, 4-16, 26, 29-41, 56 and 59- 
71 therein. 

2) Prior to September 6, 2000, we reduced our invention to 
practice, as described and claimed in the subject application, 
in Israel, a WTO country. We implemented the invention in the 
form of software code in the Java programming language. This 
code provided an application programming interface (API), 
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which enabled calls to be connected between parties via 
different service providers with different telephony signaling 
stacks, using an abstract call model, as recited in the claims 
of this patent application. The software code was tested in 
placing actual telephone calls, as described further 
hereinbelow. 

3) As evidence of the reduction to practice of the present 
invention, we attach hereto in Exhibit A selected portions of 
the software source code that we used to implement the 
invention. A directory listing in Exhibit B (generated by the 
CMVC configuration management version control system used in 
the IBM Haifa Research Laboratory) shows the dates on which 
the source code files were stored on disk. The dates of the 
files, which are blacked out in Exhibits A and B, are all 
prior to September 6, 2000 . 

4) Generally speaking, the attached software is a special 
implementation of the JTAPI specification, which we referred 
to as "Generic JTAPI" (or Gen JTAPI ) . The Gen JTAPI 
implementation provides an abstract, platform-independent call 
model with several interfaces (as shown in Fig. 2 of the 
patent application) : 

• a standard JTAPI interface for interaction with telephony 
applications; 

• a Java Telephony Service Provider Interface (JTSPI) for 
interaction with service provider plug-ins; and 

• a Java Telephony Service Management Interface (JTSMI) for 
interaction with a management plug-in, which receives call 
information, such as the telephone number of a called party, 
and returns instructions regarding selection of appropriate 
plug-ins . 
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For each party participating in a call, the GenJtapiPeer class 
in Exhibit A supplies a hybrid JTAPI provider instance, which 
interacts with the appropriate service provider plug-in via 
the JTSPI. In this manner, parties served by different 
service providers, with different telephony stacks, can be 
connected and communicate in a call initiated by a telephony 
application via the generic JTAPI layer. 

5) When an application first creates an instance of the 
GenJtapiPeer class, an initialization process is started. 
This process includes reading configuration files and creating 
a registry and other data structures that reflect registered 
service providers and resources. After the initialization 
process is finished, when the application initiates a call, 
the management (JTSMI) plug-in looks up the dialed number and 
uses it to identify the appropriate service provider for the 
called party. The application can then call the 
peer . getProvider ( ) method in Exhibit A in order to get a JTAPI 
provider instance for the specified service. 

6) The following table shows the correspondence between 
the elements of the method claims in the present patent 
application and elements of the software code in Exhibit A, 
which includes the following class listings: 

• CoreConnectTask. java 

• GenCall.java 

• GenJtapiPeer . java 

• JtsmiPlugin. java 

• MultyPluginJTSMI . java 

• ProviderPlugin . java 

• HybridProviderPlugin . j ava 
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These classes represent only a portion of the software code 
required to run GenJTAPI applications, but we believe they 
illustrate sufficiently our reduction to practice of the 
elements of the claims. The remaining classes are omitted for 
brevity. 



Claim 1 


Exhibit A 


1 . A method for 
communication, comprising : 


"Telephony" is the form of 
communication in question. 


receiving a request 
from a first party, 
submitted via a first 
communication service 
provider to a telephony 
application, to place a call 
using the application to a 
second party; 


This function is carried out by 
any sort telephony application, 
which communicates with GenJTAPI 
via the JTAPI API. The address 
(in the form of the string of 
dialedDigits ) of the second 
party is received and processed 
by the method connect ( ) listed 
on page 4 of the GenCall class 
in Exhibit A. 
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responsive to a 
characteristic of the call 
placed by the first party, 
selecting a second 
communication service 
provider to carry the call 
between the application and 
the second party; and 


The class pluginClass on page 2 
of the MultyPluginJTSMI class in 
Exhibit A associates service 
providers with address 
substrings. (The address of the 
second party is a 
"characteristic" of the call.) 
The method createEndPoints ( ) , 
which is called by init() 6rT^ 
page 3 of the MultyPluginJTSMI 
class, creates a hash table 
associating service providers 
with the corresponding plug-ins. 
These elements are used in 
providing the pluginForAddress 
string to GenJTAPI via the 
JtsmiPlugin interface class in 
Exhibit A. 


connecting the second 
party via the second 
communication service 
provider to communicate with 
the first party using the 
application, 


The connection is established by 
the run ( ) method on page 2 of 
the CoreCallTask class in 
Exhibit A. The connection uses 
the appropriate provider plug- 
ins for the first and second 
parties, as identified 
respectively by the 
connectLocalParty ( ) and 
connectRemoteParty ( ) methods . 
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wherein receiving the 
request comprises submitting 
the request to the 
application via an 
application programming 
interface (API), which 
exposes a platform- 
independent call model to 
the application, and wherein 
connecting the second party 
comprises connecting the 
call responsive to an 
instruction submitted by the 
application to the API, and 



The JTAPI API of GenJTAPI 
receives the request from the 
application. The elements of 
the platform-independent call 
model are listed in the comments 
on page 1 of the CoreCallTask 
class in Exhibit A. In response 
to the call instruction 
submitted by the application to 
JTAPI, run() calls the 
appropriate methods of the 
GenJtapiPeer class in Exhibit A 
to create the appropriate 
provider instances (as explained 
above in paragraph 4). The 
connection is established using 
the methods of the GenCall class 
in Exhibit A (inter alia), 
particularly the connect ( ) 
method on page 4 of GenCall. 
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wherein the first and 
second communication service 
providers have respective 
first and second telephony 
signaling stacks, and 
wherein the call model 
comprises an abstract call 
model that is independent of 
the telephony signaling 
stacks used in placing calls 
to and receiving calls from 
the application. 



The ProviderPlugin and 
HybridProviderPlugin classes 
defined in Exhibit A are used to 
mediate between the GenJTAPI 
layer and the telephony stacks 
of the selected providers. The 
methods in these classes 
communicate with GenJTAPI via 
JTSPI. The GenCall class of 
GenJTAPI, as noted above, 
provides the methods of an 
abstract call model that is 
independent of the provider- 
specific plug- ins . (See notes 
on page 1 of the ProviderPlugin 
class . ) 
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Claim 4 




4 . A method according to 
claim 1, wherein receiving 
the request comprises 
passing the request from the 
first telephony signaling 
stack to the abstract call 
model via a service provider 
interface of the call model, 
and wherein connecting the 
second party comprises 
passing signals to the 
second telephony signaling 
stack via the service 
provider interface, wherein 
the service provider 
interface is independent of 
the telephony signaling 
stacks . 


The methods in the 
ProviderPlugin class in Exhibit 
A, such as the prvConnectLocal ( ) 
and prvConnectRemote ( ) methods, 
are used to pass signals between 
the GenJTAPI layer and the 
respective signaling stacks of 
the first and second service 
providers in order to connect a 
hybrid call. These methods use 
the JTSPI service provider 
interface, which is the same for 
all plug-ins and is thus 
independent of the telephony 
signaling stacks. 
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Claim 5 




5. A method according to 
claim 4, wherein passing the 
request from the first 
telephony signaling stack 
comprises using a first 
plug-in program to associate 
the signals in the first 
telephony signaling stack 
with corresponding elements 
of the service provider 
interface, and wherein 
passing the signals to the 
second telephony signaling 
stack comprises using a 
second plug-in program to 
associate the signals in the 
second telephony signaling 
stack with the corresponding 
elements of the service 
provider interface . 


The provider plug-in programs 
are defined by the 
Provider Plugin and 
HybridProviderPlugin classes, as 
noted above. Each plug-in 
program includes methods such as 
ring, answer, disconnect, etc., 
which handle the corresponding 
signals in the service 
provider's signaling stack. 
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Claim 6 




6. A method according to 
claim 5, wherein selecting 
the second communication 
service provider comprises 
selecting the second plug-in 
program from among a 
plurality of the plug-in 
programs that are provided 
for interacting with the 
abstract call model. 


As noted above, the method 
init() in the MultyPlugin JTSMI 
class creates a table of 
available plug-ins. The 
getProviderPlugin ( ) method 
selects the appropriate second 
plug-in program based on the 
address of the second party. 


Claim 7 




7 . A method according' to 
claim 6, wherein selecting 
the second plug-in program 
comprises passing 
information regarding the 
call to a service manager 
program via a service 
management interface of the 
abstract call model, wherein 
the service manager program 
processes the information to 
determine the 

characteristic, and selects 
the second plug-in program 
responsive to the 
characteristic from a 
registry of the plug-in 
programs . 


The JTSMI service management 
interface is defined by the 
MultyPluginJTSMI and JtsmiPlugin 
classes. The GenJTAPI layer 
passes information regarding the 
call, i.e., a string 
representing the address of the 
second party, to the JTSMI plug- 
in via the addressConvert 
interface, and receives the name 
of the selected plug-in program 
via the pluginForAddress 
interface. The registry of 
plug-ins is created by the 
init() method, as explained 
above . 
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Claim 8 




8 . A method according to 
claim 1, wherein receiving 
the request comprises 
receiving an address of the 
second party to whom the 
call is to be placed, and 
wherein selecting the second 
communication service 
provider comprises parsing 
the address to determine the 
second communication service 
provider that should be 
selected. 


As noted above, the getAddress() 
method in the MultyPluginJTSMI 
class receives the address of 
the party to whom the call is to 
be placed. The JTSMI plug-in 
parses the address and then 
returns the pluginForAddress 
string to GenJTAPI via the 
JtsmiPlugin interface to 
indicate the selection of the 
second communication service 
provider . 


Claim 9 




9. A method according to 
claim 8, wherein receiving 
the address comprises 
receiving a telephone 
number, and wherein parsing 
the address comprises 
identifying the second 
communication provider based 
on a portion of the 
telephone number. 


As explained above, the 
connect ( ) method on page 4 of 
the GenCall class receives the 
"dialedDigits" indicating the 
telephone number of the second 
party in the call. The JTSMI 
plug-in parses this telephone 
number to identify the second 
communication provider . 
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Claim 10 

10. A method according to 
claim 1, wherein selecting 
the second communication 
service provider comprises 
determining a communication 
protocol to be used in 
communicating with the 
second party, and choosing 
the second communication 
service provider such that 
the second communication 
service provider supports 
the communication protocol. 



The GenJTAPI software code 
provided in Exhibit A was meant 
to support "hybrid calls , " i.e., 
calls between different service 
providers with different 
telephony signaling stack (and 
thus different protocols) . The 
code itself does not specify or 
limit the protocols that are to 
be supported. Rather, the JTSMI 
plug-in would have parsed the 
address of the second party in 
order to identify the 
appropriate service 
communication providers, with 
the appropriate communication 
protocol and provider plug-in. 
In regard to this claim, the 
Examiner indicated that Smyk 
(U.S. Patent 6,597,686, col. 3, 
lines 33-35, and col. 6, lines 
43-46) would have led a person 
of ordinary skill in the art to 
determine the communication 
protocol and communication 
service provider in the context 
of claim 10. 
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If this rationale were conceded 
to be correct, then it would 
have been obvious to the person 
of ordinary skill to create a 
JTSMI plug-in with this 
capability, thus implementing 
the method of claim 10 on the 
basis of the GenJTAPI software 
in Exhibit A. 


Claim 11 




11. A method according to 
claim 10, wherein receiving 
the request from the first 
party comprises 
communicating with the first 
party via the first 
communication service 
provider using a first 
communication protocol, and 
wherein the communication 
protocol used in 
communicating with the 
second party comprises a 
second communication 
protocol, different from the 
first protocol. 


As noted above in reference to 
claim 10, the GenJTAPI software 
code provided in Exhibit A was 
meant to support "hybrid calls, " 
i.e., calls between different 
service providers with different 
telephony signaling stacks (and 
thus different protocols) . The 
code itself does not specify or 
limit the protocols that are to 
be supported but clearly 
supports call scenarios in which 
the first and second parties use 
different protocols. In regard 
to this claim, the Examiner 
indicated that Smyk (same 
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passages as for claim 10) would 




have led a person of ordinary 




skill in the art to use 




different, first and second 




communication protocols in the 




context of claim 11. If this 




rationale were conceded to be 




correct, then it would have been 




obvious to the person of 




ordinary skill to use the 




GenJTAPI software in this 




manner, thus implementing the 




method of claim 11 on the basis 




of the GenJTAPI software in 




Exhibit A. 
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Claim 12 




12. A method according 


to i 


As noted above in reference to 


claim 11, wherein one of 


the 


claims 10 and 11, the GenJTAPI 


first and second 




software code does not specify 


communication protocols 




or limit the protocols that were 


comprises a circuit-switched 


to be supported in hybrid calls, 


network protocol, while 


tne 


but is clearly capable of 


other of the first and 




supporting calls between packet- 


secona comiuunica Lion 




and circuit-switched networks. 


protocols comprises a 




In regard to this claim, the 


packet-switched network 




Examiner indicated that Smyk 


protocol. 




(col. 3, lines 33-35) would have 






led a person of ordinary skill 






in the art to connect users of 






circuit-switched and packet- 






switched network protocols in 






the context of claim 12. If 






this rationale were conceded to 






be correct, then it would have 






been obvious to the person of 






ordinary skill to use the 






GenJTAPI software in this 






manner, thus implementing the 






method of claim 12 on the basis 






of the GenJTAPI software in 






Exhibit A. 
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Claim 13 

13. A method according to 
claim 1, wherein selecting 
the second communication 
service provider comprises 
specifying a selection rule, 
and applying the selection 
rule to the characteristic 
in order to determine the 
second communication service 
provider to be selected. 



As noted above, the GenJTAPI 
software code in Exhibit A 
permits the JTSMI plug-in to 
implement any sort of rules for 
selection of the second 
communication service provider. 
Although Exhibit A does not 
explicitly show any specific 
selection rules, the Examiner 
indicated that Smyk (col. 5, 
lines 50-55, and col. 5, line 67 
- col. 6, line 3) would have led 
a person of ordinary skill in 
the art to specify and apply a 
selection rule in order to 
determine the second 
communication service provider 
in the context of claim 13. If 
this rationale were conceded to 
be correct, then it would have 
been obvious to the person of 
ordinary skill to create a JTSMI 
plug-in with this capability, 
thus implementing the method of 
claim 13 on the basis of the 
GenJTAPI software in Exhibit A. 
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Claim 14 




14. A method according to 
claim 13, wherein specifying 
the selection rule comprises 
specifying a temporal 
criterion, so that the 
second communication service 
provider is selected 
depending on a point in time 
at which the call is placed. 


Although the GenJTAPI software 
code does not relate to the 
types of rules that may be 
implemented by the JTSMI plug- 
in, the Examiner indicated that 
Hetz (U.S. Patent 6,185,289, 
col. 7, lines 52-56), in 
combination with Smyk, would 
have led a person of ordinary 
skill in the art to specify time 
criteria according to which 
service providers should be 
selected in the context of claim 
14. If this rationale were 
conceded to be correct, then it 
would have been obvious to the 
person of ordinary skill to 
create a JTSMI plug-in with this 
capability, thus implementing 
the method of claim 14 on the 
basis of the GenJTAPI software 
in Exhibit A. 
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Claim 15 



15. A method according to 
claim 1, wherein the 
telephony application 
comprises a teleconferencing 
application, and wherein 
connecting the second party 
comprises establishing a 
teleconference between the 
first and second parties. 



Although the GenJTAPI software 
code provided in Exhibit A was 
meant to serve a variety of 
different telephony 
applications, the code itself 
does not specify or limit the 
types of applications for which 
it can be used. The Examiner 
indicated, however, that Smyk 
(col. 6, lines 30-32 and 43-46) 
would have led a person of 
ordinary skill in the art to 
establish a teleconference 
between the first and second 
parties in the context of claim 
15. If this rationale were 
conceded to be correct, then it 
would have been obvious to the 
person of ordinary skill to 
interface a teleconferencing 
application with the GenJTAPI 
software so as to implement the 
method of claim 15 on the basis 
of the GenJTAPI software in 
Exhibit A. 
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Claim 16 




16. A method according to 
claim 1, wherein the 
telephony application 
comprises a call center 
application, and wherein 
connecting the second party 
comprises establishing voice 
communications between a 
customer and a call center 
agent . 


As explained above, the GenJTAPI 
software code provided in 
Exhibit A does not specify or 
limit the types of applications 
for which it can be used. The 
Examiner indicated, however, 
that Smyk (col. 6, lines 30-32 
and 4 3-4 6) would have led a 
person of ordinary skill in the 
art to establish voice 
communications between a 
customer and a call center agent 
in the context of claim 16. If 
this rationale were conceded to 
be correct, then it would have 
been obvious to the person of 
ordinary skill to interface a 
call center application with the 
GenJTAPI software so as to 
implement the method of claim 16 
on the basis of the GenJTAPI 
software in Exhibit A. 



7) Claims 26, 29-41, 56 and 59-71 recite apparatus and 
computer software products, with limitations similar to those 
of method claims 1 and 4-16. Based on the similarity of 
subject matter between the method, apparatus and software 
claims, it can similarly be demonstrated that we reduced to 
practice the entire invention recited in claims 26, 29-41, 56 
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and 59-71 prior to September 6, 2006. 

8) The GenJTAPI software described above was tested in 
handling actual telephone traffic at the facilities of Sonera 

(a Finnish telecommunication service provider) prior to 
September 6, 2006. The successful test is described in an e- 
mail letter written by the project leader, Pnina Vortman, to 
IBM colleagues shortly after the test. This letter is 
attached hereto as Exhibit C. The date blacked out of the 
communication is prior to September 6, 2000. As explained in 
the letter, GenJTAPI was proven to work for its intended 
purpose in conjunction with JTSPI and Service Management 

(JTSMI) in an actual telephony application on real switching 
equipment provided by Sonera. (We note, incidentally, that 
GenJTAPI was neither publicly disclosed nor offered for sale 
in the U.S. prior to January 25, 2001.) 

We hereby declare that all statements made herein of our 
own knowledge are true and that all statements made on 
information and conjecture are thought to be true; and further 
that these statements were made with the knowledge that 
willful false statements and the like so made are punishable 
by fine or imprisonment, or both, under Section 1001 of Title 
18 of the United States Code and that such willful false 
statements may jeopardize the validity of the application of 
any patent issued thereon. 
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Samuel Kallner 
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ANNEX A 



package com. ibm. hrl . j tapi ; 



* (c) Copyright IBM Corporation 1998,1999 

* IBM Research Laboratory in Haifa 

* Generic JTAPI Implementation (JTAPI 1.2) 



Package 

Class 

Created 



com. ibm. hrl . j tapi 
CoreCallTask 



import java . util . Vector ; 

import javax. telephony . * ; 

import j avax . telephony. events . Ev; 

import javax . telephony . events . CallEv; 



import com. ibm. hrl . j tapi . j tspi . ProviderPlugin; 
import com. ibm. hrl . j tapi . util . JtapiOb j ectCreator ; 



* Implements ConnectTask for the Core package. 

* Allows asynchronously placing outgoing calls. 

* According to explanation of <code>j avax . telephony . Call . connect () , the task 

* does following: 

* <OL> 

* <LI>The originating Connection moves from the <code>Connection . IDLE</code> 

* state into the <code>Connection . CONNECTED</code> state. 

* A <code>TerminalConnection</code> is created in the 

* <code>TerminalConnection. IDLE</code> state and moves to 

* the <CODE>TerminalConnection. ACTIVE</CODE> state. 

* <p> 

* <B>Events delivered to the application : </B> ■ 

* a <code>ConnectionEvent . CONNECTION_CONNECTED</code> / <code>ConnConnectedEv</code> 

* for the originating Connection, 

* a <code>TerminalConnect ionEvent . TERMINAL_CONNECTION_CREATED</ code> / 

* <code>TermConnCreatedEv</code> and a 

* <code>TerminalConnection.TERMINAL_CONNECTION_ACTIVE</code> / 

* <code>TermConnActiveEv</code>f or the new <code>TerminalConnection</code> . 

* <p> 

* If the originating <code>Address</code> has more than one <code>Terminal</code> / 

* these additional <code>Terminal</code>s are involved in the telephone call. 

* Additional <code>TerminalConnection</code> objects associated 

* with the originating <code>Connection</code> and these <code>Terminal</code>s 

* are created. For each <code>TerminalConnection</code> created a 

* <code>TerminalConnectionEvent . TERMINAL_CONNECTION_CREATED</code> / 

* <code>TermConnC-reatedEv</code> is delivered. These <code>TerminalConnection</code>s 

* will be in the <code>TerminalConnection . PASSIVE</code> state and a 

* <code>TerminalConnectionEvent . TERMINAL_CONNECTION_PASSIVE<code> / 

* <code>TermConnPassiveEv</code> is delivered for each. 

* <p> 

* <LI>The destination <code>Connection moves into the 

* <code>Connection. INPROGRESS</code> state as the Call proceeds. 

* <p> 

* <B>Events delivered to the application : </B> a 

* <code>ConnectionEvent . CONNECTION_IN_PROGRESS</code> / <code>ConnInProgressEv</code> 

* for the destination <code>Connection</code> . 
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* <p> 

* <LI>Next steps of the connection sequence operation are done as ringing calback. 

* </0L> 

•* 

* @see javax. telephony. Call#connect (Terminal, Address, String) 
* 

* @author Alexey Roytman 
*/ 

public class CoreConnectTask implements Runnable 
{ 

// IBM Copyright 

public static final String IBM_Copyright - Copyright . SHORT_STRING; 
/* 

* Attributes 
*/ 

protected GenCall m_call; 

protected GenTerminal m_localTerminal; 

protected GenAddress m_localAddress, m_des t Address ; 

protected int m_observCause ; 
protected int m_observMeta ; 

protected int m_opCode; 

// ctors 

* 

* Constructor for outgoing call task. 
★ 

* @param call The given outgoing Call. 

* @param localAddress The given local <core>Address</code> 

* @param localTerminal The given local <core>Terminal</core> 

* Gparam destAddress The given destination <core>Address</code> 
*/ 

public CoreConnectTask ( GenCall call, GenAddress localAddress, 

GenTerminal localTerminal, GenAddress destAddress ) 

{ 

m_call = call ; 

m_localAddress = localAddress; 

m_localTerminal = localTerminal; 

m_destAddress = destAddress; 

m_opCode = CoreOperations . CALL_CONNECT_OP; 

m_observCause = Ev . CAUSE_NORMAL ; 

m_observMeta = Ev . META_CALL_STARTING; 

} 

public void run ( ) 
{ 

String callld = m_call . getld ( ) ; 

String localAddressName = m_localAddress . getName ( ) ; 
String destAddressName = m_destAddress . getName () ; 

synchronized ( callld ) 

{ 
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GenConnection localConnection = 

m_call . getConnection ( localAddressName ) ; 
if( null =- localConnection ) 
{ 

GenJtapiPeer .ms_log . errorMessage ( 

"CoreConnectTask: cannot get local connection"); 

return; 

} 

GenConnection remoteConnection — 

m_call . getConnection (destAddressName ) ; 
if( null ~ remoteConnection ) 
{ 

GenJtapiPeer .ms__log . errorMessage ( 

"CoreConnectTask: cannot get remote connection") ; 
return; 

} 

if( connectLocalParty ( localConnection ) ) 
{ 

connectRemoteParty ( remoteConnection ); 

} 

} 

} 



protected boolean connectLocalParty ( GenConnection connection ) 
{ 

ProviderPlugin provPlugin = m_localAddress . get ProviderPlugin () ; 
GenProvider provider = (GenProvider ) m_call . getProvider ( ) ; 
JtapiObj ectCreator creator = provider . getObjectCreator () ; 
// address, we should create PASSIVE terminal connection 

GenTerminal [ ] terminals = (GenTerminal [ ] ) m_localAddress . getTerminals ( ) ; 
String localAddressName = m_localAddress . getName { ) ; 
String callld = m_call . getld ( ) ; 
for(int i=0; Kterminals . length; i++) 
{ 

try 
{ 

provPlugin . prvConnectLocal (callld, localAddressName, 

terminals [ i ] . getName ( ) ) ; 

} 

catch ( Exception exc ) 
{ 

GenJtapiPeer .ms_log . errorMessage ( 

"CoreConnectTask: placeOutgoingCall : ", exc); 
m_cali . disconnectPart ( localAddressName, terminals [i] .getName (), 

0, CoreOperations . FAILED__CB) ; 

return false; 

} 

GenTerminalConnection tconn = 

creator. createTerminalConnection (terminals [i] , connection, 

m_observCause, m_observMeta, 

false) ; 

if (terminals [i] != m_localTerminal ) 
{ 

tconn . moveToState ( TerminalConnection . PASSIVE, m_observCause , 

m_observMeta, false, m_opCode) ; 

} 

else 
{ 
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tconn.moveToState (TerminalConnect ion .ACTIVE, m_observCause, 

m_observMeta, false, m_opCode) ; 

} 

} 

// move local, connection to CONNECTED state 

connection . moveToState ( Connection . CONNECTED, m_observCause, 

m_observMeta, false, m_opCode) ; 

return true; 

} 

f * * 

* This method serves as the final part of a standard routine for 

* connection of outgoing call. 

* <p> 

* Moves destination (remote) connection to the INPROGRESS state. 
* 

* @param connection The given destination <code>Connection</code> . 

* ©return <code>true</code> if the method is succeed, <code>f alse</code> 

* otherwise. 
*/ 

protected boolean connectRemoteParty ( GenConnect ion connection ) 
{ 

// get required objects 

ProviderPlugin provPlugin = m_destAddress . get ProviderPlugin () ; 
String callld = m_call . get Id ( ) ; 

String destAddressName = m_destAddress . getName ( ) ; 
GenJtapiPeer .ms_log . progressives sage ( 

"CoreConnectTask: Connecting remote party: " + destAddressName) 

try 
{ 

provPlugin . prvConnectRemote ( callld, destAddressName) ; 

} 

catch ( Exception exc ) 
{ 

GenJtapiPeer . ms_log . errorMessage ( 

"CoreConnectTask: Connecting remote party: ", exc) ; 

try 
{ 

/ / roolback 

connection . disconnect () ; 

} 

catch (Exception e) 
{ 

GenJtapiPeer . ms_log . warningMessage ( 

"CoreConnectTask: Connecting remote party: ", e) ; 

} 

return false; 

} 

// move dest connection to INPROGRESS state 

connection. moveToState ( Connection. INPROGRESS, m_observCause, 

m_observMeta, false, m_opCode) ; 

return true; 

} 
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package com . ibm . hrl . j tapi ; 



/* 

* (c) Copyright IBM Corporation 1998,1999,2000 

* IBM Research Laboratory in Haifa 

* Generic JTAPI Implementation (JTAPI 1.3) 



Package 

Class 

Created 



com . ibm . hrl . j tapi 
GenCall 



*/ 

import j ava . util . Vector ; 

import javax . telephony . * ; 
import j a vax . telephony . event s . * ; 

import javax . telephony. capabilities . CallCapabilities ; 

import com. ibm. hrl . j tapi . capabilities . * ; 

import com. ibm. hrl . j tapi . events . * ; 

import com. ibm. hrl . j tapi . j tspi . ProviderPlugin; 

import com. ibm. hrl . j tapi . j tspi . JtspiException; 

import com. ibm. hrl . j tapi . util . JtapiOb j ectCreator ; 

import com. ibm. hrl . j tapi . util . JtapiObj ectNotif ier ; 

import com. ibm. hrl . util . ArrayUtils; 

import com. ibm. telephony. ics . ICSCall; 
/ * * 

* Generic implementation of the <code>Call</code> interface. 

* for the Core package. 

* @see javax. telephony .Call 
★ 

* ^author Lev Kozakov 

* Qauthor Alexey Roytman 
*/ 

public class GenCall implements Call, ICSCall 
{ 

// IBM Copyright 

public static final String IBM_Copyright = Copyright . SHORT_STRING; 

protected Vector m_connections; 
protected GenAddress m_origAddress ; 
protected GenTerminal m_origTerminal ; 
protected GenAddress m_destAddress ; 
protected Vector m_observers; 

// Added support for the Listener model of JTAPI 1.3 
protected Vector m^listeners; 
protected GenProvider m_provider; 
protected boolean m_isFirstParty; 
protected int m_coreState = Call. IDLE; 

protected String m__id; 

protected GenCallCapabilities m_statCapabilities ; 

// ctors 

/ * ★ 

* Constructs new <code>GenCall</code> object, using reference to a given 

* <code>GenProvider</code>, a ID of the created <code>Call</code> and flag, 
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* which define party of the <code>GenCall</code> . 

* @param provider The reference to <code>GenProvider</code> 

* @param id The identifier (name) of the , code>GenCall</code> 

* @param isFirstParty <code>true</code> if the call is first party call, 

* <code>f alse</code> otherwise. 
*/ 

public GenCall (GenProvider provider, String id, boolean isFirstParty ) 

throws InvalidStateException 

{ 

provider .assert IN_SERVICE ( 

"Provider should be in the \ " IN_SERVICE\ " state to create new call"); 
m_id = id; 

m_isFirstParty = isFirstParty; 
m_provider = provider; 
m^connections = new Vector ( ) ; 
m_observers = new Vector ( ) ; 
m_listeners = new Vector ( ) ; 

m_statCapabilities = (GenCallCapabilities ) provider . getCallCapabilities ( ) ; 



// JTAPI methods 

/** 

* Adds an listener to this <code>Call</code> object. 

* <p> 

* This method implements the j avax . telephony . Call . addCallListener (CallListener) 

* method. 

* <p> 

* <B>Post-conditions : </B> 

* <0L> 

* <LI>listener is an element of this . getCallListeners ( ) . 

* <LI>A snapshot of events is delivered to the listener, if appropriate. 

* </0L> 
* 

* @param listener The listener being added. 

* ^exception j avax . telephony . MethodNotSupportedException if the observer 

* cannot be added at this time. 

* ©exception j avax . telephony . ResourceUnavailableException if the resource 

* limit for the number of listeners has been exceeded. 
★ 

* @see javax . telephony . Call#addCallListener 
*/ 

public void addCallListener (CallListener listener) 

throws ResourceUnavailableException, MethodNotSupportedException 

{ 

synchronized (m_listeners ) 
{ 

if ( listener == null || m_listeners . contains (listener ) ) 
{ 

return; 

} 

m_listeners . addElement (listener) ; 

} 

notif yStateSnapshot (listener) ; 
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* Returns an array of <code>Connection</code> objects associated with this 

* <code>GenCall</code> . 

* <p> 

* This method implements the 

* <code> j a vax . telephony . Call . getConnect ions ( ) </code> method . 

* <p> 

* <B>Post-conditions : </B> 

* <0L> 

* <LI>Let Connection [] conn = Call . getConnect ions ( ) 

* <LI>if this . getState ( ) == Call. IDLE then conn = null 

* <LI>if this .getState { ) == Call. INVALID then conn = null 

* <LI>if this .getState ( ) == Call. ACTIVE then conn. length >= 1 

* <LI>For all i, conn [ i ]. getState ( ) != Connection . DISCONNECTED 

* </OL> 

* ©return An array of <code>Connection</code> objects associated with this 

* <code>Call</code> . 

* @see javax . telephony . Call#getConnections 
*/ 

public Connection [] getConnections ( ) 
{ 

synchronized (m_connections ) 
{ 

if ( m^connections . size () == 0 ) 
{ 

return null; 

} 

GenConnection ret [] = new GenConnection [m_connections . size ( ) ] ; 
m_connections . copylnto ( ret ); 
return ret; 

} 

} 

/★* 

* Places a telephone call from an originating endpoint to a destination 

* address string. 

* <p> 

* This method implements the <code>j avax . telephony . Call . connect () </code> 

* method. 

* <p> 

* <B>Pre-conditions : </B> 

* <0L> 

* <LI> ( this. getProvider ()) .getState () == Provider . IN_SERVICE 

* <LI>this. getState ( ) ~ Call. IDLE 

* </0L> 

* <B>Post-conditions : </B> 

* <0L> 

* <LI>(this. getProvider ()) .getState () == Provider . IN_SERVICE 

* <LI>this. getState () == Call. ACTIVE 

* <LI>Let Connection c[] = this . getConnections ( ) 

* <LI>c. length == 2 

* <LI>c[0] .getState() == Connection . IDLE (at least) 

* <LI>c [1] . getState ( ) — Connection . IDLE (at least) 

* </0L> 
* 

* @param origterm The given originating <code>Terminal</code> . 

* @param origaddr The given originating <code>Address</code> . 

* Qparam destString The given destination endpoint string. 
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* ©exception j avax . telephony . ResourceUnavailableException if an internal 

* resource necessary for placing the phone call is unavailable. 

* ©exception j avax . telephony . PrivilegeViolationException if the 

* application does not have the proper authority to place a telephone 

* call. 

* ©exception javax . telephony . InvalidPartyException if either the 

* originator or the destination does not represent a valid party 

* required to place a telephone call. 

* ©exception javax . telephony . InvalidArgumentException if an argument 

* provided is not valid either by not providing enough information for 

* this method or is inconsistent with another argument. 

* ©exception j avax . telephony . InvalidStateException if some object 

* required by this method is not in a valid state as designated by the 

* pre-conditions for this method. 

* ©exception javax . telephony . MethodNotSupportedException if the 

* implementation does not support this method. 

* ©see j avax . telephony . Call#connect 

* ©see com. ibm. hrl . j tapi . CoreConnectTask 
*/ 

public Connection [] connect (Terminal localTerm, Address localAddr, 

. String dialedDigit s ) 
throws ResourceUnavailableException, 

PrivilegeViolationException, InvalidPartyException, 
InvalidArgumentException, InvalidStateException, 
MethodNotSupportedException 



// TBD: check application privileges 
// check capabilities 

if( ! m_statCapabilities . canConnect ( ) ) 
{ 

throw new MethodNotSupportedException ( 

H GenCall: connect: method is not supported") ; 

} 

// check arguments 

GenTerminal . assertValid ( localTerm ); 
GenAddress . assertValid ( localAddr ) ; 
if (null == dialedDigits ) 
{ 

throw new InvalidArgumentExcept ion ( "distination address is null"); 

} 

// check preconditions for main objects 
m_provider . assert IN_SERVICE ( 

"Provider should be in the \"IN_SERVICE\" state for Call. connect operation"); 

GenTerminal localTerminal = (GenTerminal ) localTerm; 
GenAddress localAddress = (GenAddress ) localAddr ; 

// localTerm and localAddr should be local 
localTerminal . assertLocal () ; 
localAddress . assertLocal ( ) ; 

// there should be association between origterm and origaddr 

if (! localTerminal . isAssociated ( localAddress )) 

{ 

throw new InvalidPartyException ( 
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InvalidPartyExcept ion . ORIGINATING_PARTY, 

"GenCall . connect : no address- terminal association" ); 

} 

m_orig Address = localAddress; 
m_origTerminal = localTerminal ; 

GenConnection [ ] newConnections = new GenConnection [ 2] ; 
JtapiObjectCreator- creator = m_provider . getObj ectCreator ( ) ; 

synchronized (m_id) 
{ 

assertState ( 

"The Call should be in the \"IDLE\" state for Call. connect operation", 

Call. IDLE ) ; 

try 

{ 

addObservers ( localAddress . getCallObservers ( ) ) ; 
addCallListeners (localAddress . getCallListeners ( ) ) ; 
Terminal [] terminals = localAddress . getTerminals () ; 
for(int i=0; i< terminals . length; i++) 
{ 

addObservers (terminals [i] . getCallObservers ( ) ) ; 
addCallListeners (terminals [i] . getCallListeners ( ) ) ; 

} 

} 

catch ( Exception e ) 
{ 

/* The "possible" exceptions are ResourceUnavailableExcept ion and 
MethodNotSupportedException . These exception cannot be thrown 
in our implementation in this place. */ 

Gen JtapiPeer . ms_log . warningMessage ( "GenCall : connect " + e); 

} 

/* 

1. The Call . connect { ) method is invoked with the given arguments. 
Two Connection objects are created and returned, each in the 
Connection . IDLE state . 

Events delivered to the application: a CallActivEv and 
two ConnCreatedEv, one for each Connection. 

*/ 

int observMeta = Ev . META_CALL_STARTING, observCause = Ev . CAUSE_NORMAL; 
ProviderPlugin provPlugin = localAddress . get ProviderPlugin () ; 

if ( m_provider . isLocalAddress ( dialedDigits )) 
{ 

m_destAddress = ( GenAddress ) m_provider . get Address ( dialedDigits ); 

} 

else 
{ 

m_destAddress = creator . createRemoteAddress (m_provider, provPlugin, 

dialedDigits); * 

} 

newConnections [ 0 ] = creator . createConnection ( this, localAddress, 

observCause, observMeta, true ) ; 

newConnections [ 1 ] = creator . createConnection ( this , m_destAddress , 

observCause, observMeta, false) ; 

moveToState( Call. ACTIVE, observCause, observMeta, false, 
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CoreOperations . CALL_CONNECT_OP ) ; 
// start placing call 

m_provider.runIt ( new CoreConnectTask ( this, localAddress , 
localTerminal, m_destAddress ) ) ; 

} 

return newConnections ; 

} 



* Adds a given <code>CallObserver</code> object to this <code>Call</code> . 

* <p> 

* This method implements the <code>j avax . telephony . Call . addObserver ( ) 

* </code> method. 

* <p> 

* <B>Post-Conditions : </B> 

* <0L> 

* <LI>observer is an element of <code>this . getObservers ( ) </code> 

* <LI>A snapshot of events is delivered to the observer, if appropriate. 

* </0L> 
* 

* @param observer The given <code>Ca!10bserver</code> to be added. 
* 

* ©exception j avax . telephony . ResourceUnavailableExcept ion if the resource 

* limit for the number of observers has been exceeded. 

* ©exception j avax . telephony . MethodNot Support edException if the observer 

* cannot be added at this time 
* 

* @see javax . telephony . Call#addObserver 
*/ 

public void addObserver (CallObserver observer) 

throws ResourceUnavailableExcept ion, MethodNot Support edException 

{ 

if ( ! m_statCapabilities . isObservable ( ) ) 
{ 

throw new MethodNotSupportedException ( 

" GenCall: addObserver: method is not supported") ; 

} 

synchroni zed (m_observers ) 
{ 

if (null == observer || m_observers . contains ( observer ) ) 
{ 

return; 

} . 
m_observers . addElement (observer) ; 

} 

notif yStateSnapshot ( observer ); 



I * + 

* Returns a list of all <code>CallListeners</code> objects associated 

* with this <code>Call</code> object. 

* <p> 

* This method implements the <code>j avax . telephony . Call . getCallListeners ( ) 

* </code> method. 

* <p> 

* <B>Post-conditions : </B> 

* <OL> 

* <LI>Let CallListeners [] listeners = this . getCallListeners ( ) 

* <LI>listeners — null or listeners . length >= 1 
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* </0L> 
* 

* ©return An array of all <code>CallListeners</code> objects associated 

* with this <code>Call</code> . 
* 

* @see javax. telephony . Call#getCallListeners 
*/ 

public CallListener [ ] getCallListeners ( ) 
< 

synchronized ( m_listeners ) 
{ 

if (m_listeners . size ( ) == 0) 
{ 

return null; 

} 

CallListener [ ] array = new CallListener [m_listeners . size ()] ; 
m__listeners . copylnto (array) ; 
return array; 

} 

} 



* Returns, an array of all <code>CallObserver</code> objects on 

* this <code>Call</code>. 

* <p> 

* This method implements the <code>j avax . telephony . Call . getObservers ( ) 

* </code> method . 

* <p> 

* <B>Post-Conditions : </B> 

* <0L> 

* <LI>Let CallObserver [ ] obs = this . getObservers ( ) 

* <LI>obs == null or obs. length >= 1 

* </0L> 
* 

* ©return An array of all <code>CallObserver</code> objects on this 

* <code>Call</code>. 
*/ 

public CallObserver [ ] getObservers ( ) 
{ 

synchronized ( m_observers ) 
{ 

if ( m_observers . size ( ) == 0 ) 
{ 

return null; 

} 

CallObserver [ ] array = new CallObserver [m_observers . size ()] ; 
m_observers . copylnto ( array ); 
return array; 

} 

} 

/ * * 

* Removes the given observer from this <code>GenCall</code> . 

* <p> 

* This method implements the <code>j avax . telephony . Call . removeObserver ( ) 

* </code> method. 

* <p> 

* <B>Post-Conditions : </B> 

* <OL> 
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* <LI>observer is not an element of this . getObservers ( ) 

* <LI>CallObservationEndedEv is delivered to the application 

*-</OL> 
* 

* @param observer The <code>CallObserver</code> to be removed. 
* 

* @see javax. telephony . Call#removeObserver 

* @see com. ibm. hrl . j tapi . GenCallObservationEndedEv 
*/ 

public void removeObserver (CallObserver observer) 
{ 

if { null != observer ) 
{ 

if( m_observers . removeElement ( observer )) 
{ 

notif yObserverRemoved ( observer ); 

} 

} 



* Returns the <code>Provider</code> associated with this <code>GenCall</code> 

* <p> 

* This method implements the <code>j avax . telephony . Call . get Provider () </code> 

* method. 
* 

* @return The <code>Provider</code> associated with this <code>GenCall</code> 
*/ 

public final Provider get Provider { ) 
{ 

return m_jprovider; 

} 

I * * 

* Returns the dynamic capabilities for the instance of the 

* <code>Call</code> object with respect to a <code>Terminal</code> 

* and an <code>Address</code> . 

* <p> 

* This method implements the <code>j avax . telephony . Call . getCapabilities ( ) 

* </code> method. 
* 

* Greturn The dynamic <code>Call</code> capabilities. 
* 

* @param terminal Dynamic capabilities are with respect to this 

* <code>Terminal</code> . 

* @param address Dynamic capabilities are with respect to this 

* <code>Address</code> . 
* 

* @except ion j avax . telephony . InvalidArgumentException indicates the 

* <code>Terminal</code> and/or <code>Address</code> argument provided 

* was not valid. 

V 

public CallCapabilities getCapabilities (Terminal terminal, Address address) 

throws InvalidArgumentException 

{ 

return GenDynCallCapabilities . createDynCapabilities ( m_statCapabilities, 

this, (GenAddress ) address, (GenTerminal ) terminal ) ; 

} 
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/★ * 

* Gets the <code>CallCapabilities</code> object with respect to a 

* <code>Terminal</code> and an <code>Address</code> . If <code>null</code> 

* is passed as a <code>Terminal</code> parameter, the general/provider-wide 

* <code>Call</code> capabilities are returned. 

* <p> 

* This method implements the <code> 

* javax . telephony . Call . getCallCapabilities (Terminal, Address ) </code> method. 
* 

* ©deprecated Since JTAPI vl.2. This method has been replaced by the 

* <code>Call . getCapabilities ( ) </code> method. Now the method invokes the 

* <code>Call . getCapabilities () </code> method with the given <code>Terminal 

* </code> and <code>Address</code> arguments. 
* 

* ©return The <code>CallCapabilities</code> object with respect to a 

* <code>Terminal</code> and an <code>Address</code> . 
* 

* @param terminal The given <code>Terminal</code> . 

* ©param address The given <code>Address</code> . 
+ 

* ©exception j avax . telephony . InvalidArgumentException indicates the 

* •<code>Terminal</code> and/or <code>Address</code> argument provided 

* was not valid. 

* ©exception j avax . telephony . Platf ormException if platform-specific 

* exception occurred. 
*/ 

public final CallCapabilities getCallCapabilities (Terminal term, Address addr) 

throws InvalidArgumentException, Plat f ormException 

{ 

return getCapabilities (term, addr) ; 



/ ★ * 

* Returns the current Core state of the telephone <code>Call</code>. 

* <p> 

* This method implements the <code>j avax . telephony . Call . getState () </code> 

* method. 
* 

* ©return The current state of the telephone <code>Call</code> . 
*/ 

public final int getState ( ) 
{ 

return m coreState; 



I * * 

* Removes the given listener from the <code>Call</code> . 

* <p> 

* This method implements the 

* <code>javax. telephony . Call . removeCallListener ( ) </code> method. 

* <p> 

* <B>Post-conditions : </B> 

* <0L> 

* <LI>listener is not an element of this . removeProviderListener ( ) 

* <LI>ProviderEvent with id <code>CALL_EVENT_TRANSMISSION_ENDED</code> 
* is delivered to listener 

* </0L> 

* ©param listener The Provider Listener to be removed. 
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+ (a see j avax . telephony . Call#removeCallListener 
* @see com. ibm. hrl . j tapi . GenCall#addCallListener 
*/ 

public void removeCallListener (CallListener listener) 
{ 

if (listener != null) 
{ 

if (m_listeners . removeElement (listener) ) 
{ 

notif yListenerRemoved ( listener) ; 

} 

} 

} 



// ICS exstantions 



/ * * 

* Transfers the given Core state of the telephone <code>Call</code> 

* in the form of a String. 

* <p> 

* This is an extensionn from ZRL. 
* 

* @param state the given state 

* @return The current state of the telephone <code>Call</code> as a String 
*/ 

public String getStateName ( int state) 
{ 

switch (state) 
{ 

case Call. IDLE: 

return "Idle"; 
case Call. ACTIVE: 

return "Active"; 
case Call. INVALID: 

return "Invalid"; 
default : 

return "Unknown"; 

} 

} 

/* * 

* Returns the current Core state of the telephone <code>Call</code>. 

* in the form of a String. 

* <p> 

* This is an extension from ZRL. 
* 

* ©return The current state of the telephone <code>Call</code> as a String 
*/ 

public String getStateName ( ) 
{ 

return getStateName (m_coreState ) ; 

} 

// Implementation methods 

f * * 

* Returns <code>String</code> representation of the <code>GenCall</code> 
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* ©return <code>String</code> representation of the <code>GenCall</code> 
*/ 

public String toString() 
{ 

String className = getClass ( ) . getName ( ) ; 
StringBuffer buff = new StringBuf f er ( 

className . substring ( className . lastlndexOf ( 1 ) +1 ) ) 
buff. append ( " { has " ); 
buf f . append ( m_connect ions .sized ) ; 
buff. append ( " connections } in the state " ); 
buff. append ( getStateName ( ) ); 
return buf f . toString ( ) ; 



* Returns the global unique ID of this call object. 
* 

* ©return The global unique ID of this call object. 
*/ 

public final String getld ( ) 
{ 

return m id; 



* Returns <code>true</code> if this <code>GenCall</code> is first party 

* call, <code>f alse>/code> otherwise. 
* 

* @return <code>true</code> if this <code>GenCall</code> is first party 

* call, <code>f alse>/code> otherwise. 
*/ 

public final boolean isFirst Party ( ) 
{ 

return m_isFirst Party ; 

} 

/* * 

* Returns <code>true</code> if this <code>GenCall</code> contains the 

* given <code>TerminalConnection</code>, <code>false>/code> otherwise. 
* 

* ©return <code>true</code> if this <code>GenCall</code> contains the 

* given <code>TerminalConnection</code>, <code>f alse>/code> otherwise. 
* 

* ©exception IllegalArgumentException in the case of null argument 
*/ 

protected boolean contains ( TerminalConnection tc) 
{ 

if( null == tc) 
{ 

throw new IllegalArgumentException ( 

"GenCall . contains (TerminalConnection) : null argument" ) ; 

} 

synchronized ( m__connections ) 
{ 

int size = m_connections . size ( ) ; 
TerminalConnection [ ] tConnections ; 
for (int i=0; i< size; i++) 
{ 
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tConnections = ( (GenConnection)m_connections.elementAt(i) ) . 

getTerminalConnections ( ) ; 
f or ( int j=0; j <tConnections . length; j++) 
{ 

if ( tConnections [j ] == tc) 
{ 

return true; 

} 

} 

} 

return false; 

} 

} 

* Throws InvalidStateException with given messag, if this 

* <code>GenCall</code> is not in the given state. 

* @param message the message for exception. 

* @param state the given call state. 

* ^exception javax . telephony . InvalidStateException Call is not in the 

* given state. 
*/ 

public void assertState (String message, int state) throws InvalidStateException 
{ 

int callState = m_coreState; 

if ( state != callState ) { 

throw new InvalidStateException ( this, 

InvalidStateException. CALL_OBJECT, 
callState, message ) ; 

} 

} 

/* * 

* Throws InvalidStateException with difault messag, if this 

* <code>GenCall</code> is not in the given state. 
* 

* ^exception j avax . telephony . InvalidStateException Call is not in the 

* given state. 
*/ 

public void assertState ( int state) throws InvalidStateException 
{ 

String message = "the call is not " + getStateName ( state ); 
assertState ( message, state); 



* Moves this <code>GenCall</code> to the given state. 

* Notifies registered observers and listeners about the last 

* state change. 

* @param state The given state value. 

* dparam cause The given cause ID. 

* @param meta The given meta-code. 

* @param isNewMetaEv <code>true</code> if the change starts new sequence of 

* meta events, <code>f alse</code> otherwise. 

* @param opCode The given operation code. 

* Gexception j avax . telephony . InvalidArgumentException The given state is not 

* valid Call state. 
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*/ 

public void moveToState ( int state, int cause, int meta, 

boolean isNewMetaEv, int opCode) 

{ 

synchronized (m_id) 
{ 

if ( state == m_coreState ) 
{ 

return; 

} 

switch ( state ) 
{ 

case Call. INVALID : 
case Call. IDLE : 
case Call. ACTIVE : 

. m_coreState = state; 
break; 
• default : 

throw new IllegalArgumentException ( "invalid Call state - " + state 

} 

stateChanged ( cause, meta, isNewMetaEv ); 

} 

} 

/* * 

* Notifies all registered observers and listeners asynchronously 

* about the last state change. 
* 

* 0param cause The given cause code. 

* @param meta The given meta-code. 

* @param isNewMetaEv <code>true</code> if the change starts new sequence of 

* meta events, <code>false</code> otherwise. 
*/ 

protected void stateChanged ( int cause, int meta, ' boolean isNewMetaEv ) 
{ 

CallObserver [ ] obList = getObservers ( ) ; 

if( obList != null ) 

{ 

CallEv[] evList = getLastStateObEvents ( cause, meta, isNewMetaEv); 

if ( evList != null ) 

{ 

JtapiObjectNotif ier . getlnstance (). enqueue ( obList, evList ); 

} 

} 

CallListener [ ] IsList = getCallListeners ( ) ; 

if (IsList != null) 

{ 

CallEvent[] evList = getLastStateListenEvent s ( cause, meta, isNewMetaEv); 
if ( evList != null ) 

{ 

JtapiObjectNotif ier . getlnstance (). enqueue ( IsList, evList ); 

} 

} 



/ * * 

* Returns array of CallEv objects, associated with the last state change. 
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+ 

* ©return The array of CallEv objects, associated with the last 

* state change. 

* @param cause The given cause code. 

* @param meta The given meta-code. 

* @param isNewMetaEv <code>true</code> if the change starts new sequence of 

* meta events, <code>f alse</code> otherwise. 
*/ 

protected CallEv [] getLastStateObEvents ( int cause, int meta, 

boolean isNewMetaEv) 

{ 

CallEv [] events = new CallEv[l]; 

switch ( m_coreState ) 

{ 

case Call. ACTIVE : 

events[0] = new GenCallAct iveEv ( this, cause, meta, isNewMetaEv ); 

return events; 
case Call. INVALID : 

events [0] = new GenCalllnvalidEv ( this, cause, meta, isNewMetaEv ) 

return events; 
default : 

return null; 

} 

} 



* Returns array of CallEvent objects, associated with the last state change 
* 

* @return The array of CallEvent objects, associated with the last 

* state change . 

* @param cause The given cause code. 

* @param meta The given meta-code. 

* Gparam isNewMetaEv <code>true</code> if the change starts new sequence of 

* meta events, <code>f alse</code> otherwise. 

. "*/ 

protected CallEvent [] getLastStateListenEvent s ( int cause, int meta, 

boolean isNewMetaEv) 

{ 

CallEvent [] events = new CallEvent [1] ; 
switch ( m_coreState ) 

{ 

case Call. ACTIVE: 

{ 

events [0] = new GenCallEvent (this , CallEvent . CALL_ACTIVE, 

cause) ; 

break; 

} 

case Call. INVALID: 

{ 

events [0] = new GenCallEvent (this, CallEvent . CALL_INVALID, 

cause) ; 

break; 

} 

default : 

{ 

return null; 

} 
} 

return events; 
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} 



/ * * 

* Notifies a given call observer asynchronously 

* about the current state snapshot. 
* 

* @param observer The given call observer. 
*/ 

protected void notif yStateSnapshot ( CallObserver observer ) 
{ 

CallObserver [ ] obList = { observer }; 
CallEv[] evList = 

getLastStateObEvents ( Ev . CAUSE_S NAP SHOT, Ev . META_SNAPSHOT , true); 

if ( evList != null ) 

{ 

GenConnection [] connections = (GenConnection [ ] ) getConnections ( ) ; 

if ( null == connections ) 

{ 

JtapiObjectNotif ier .getlnstance () . enqueue ( obList, evList ); 
return; 

} 

Vector vector = new Vector () ; 
ArrayUtils . append ( vector, evList ); 

f or ( int i = 0; i < connections . length; i++ ) 
{ 

CallEv[] connEvList = connections [ i] . getLastCoreStateEvents ( 

Ev.CAUSE_SNAPSHOT, Ev . META_SNAPSHOT , false) ; 
if ( connEvList ! = null ) 
{ 

ArrayUtils . append ( vector, connEvList ); 

} 

TerminalConnection [ ] tconArray = 

connections [i] . getTerminalConnect ions ( ) ; 

if { tconArray != null ) 
{ 

f or ( int j = 0; j < tconArray . length; j++ ) 
{ 

GenTerminalConnection tconltem = 

(GenTerminalConnection) tconArray [j] ; 
CallEvf] tconEvList = tconltem . getLastCoreStateEvents ( 

Ev.CAUSE_SNAPSHOT, Ev . META_SNAPSHOT , false ); 
if ( tconEvList != null ) 
{ 

ArrayUtils . append ( vector, tconEvList ); 

.} 

} 

} 

} 

if( vector. size () > 0 ) 
{ 

// copy to array 

evList = new CallEv [vector . size ()]; 
vector . copylnto ( evList ); 

} 

JtapiObjectNotif ier . getlnstance (). enqueue ( obList, evList ); 

} 

} 
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/ * * 

* Notifies a given call listener asynchronously 

* about the current state snapshot. 
★ 

* @param listener The given call listener. 
*/ 

protected void notif yStateSnapshot (CallListener listener) 
{ 

CallListener [ ] IsList = { listener }; 

CallEvent [] evList = getLastStateListenEvents (CallEvent . CAUSE_SNAPSHOT, 0, 

true) ; 

if (evList != null) 
{ * 

GenConnection [ ] connections = (GenConnection [ ] ) getConnections ( ) ; 
if ( null == connections ) 
{ 

JtapiObjectNotif ier . getlnstance (). enqueue ( IsList, evList ); 
return; 

} 

Vector vector = new Vector { ) ; 

ArrayUtils . append ( vector, evList ); 

f or ( int i = 0; i < connections . length; i++ ) 

{ 

CallEvent [] connEvList = 
connections [i] . getLastCoreStateEventsEx (CallEvent . CAUSE_SNAPSHOT , 0) ; 

if ( connEvList != null ) 

{ 

ArrayUtils . append ( vector, connEvList ); 

} 

TerminalConnection [ ] tconArray = 
connections [i] . getTerminalConnect ions ( ) ; 

if ( tconArray != null ) 

{ 

for ( int j=0; j < tconArray . length; j++ ) 

{ 

GenTerminalConnection tconltem = 
(GenTerminalConnection) tconArray [j] ; 

CallEvent [] tconEvList = 
tconltem. getLastCoreStateEventsEx (CallEvent . CAUSE_SNAPSHOT / 

0, false) ; 

if ( tconEvList != null ) 

{ 

ArrayUtils . append ( vector, tconEvList ) 

} 

} 

} 

} 

if ( vector. size () > 0 ) 

{ 

// copy to array 

evList = new CallEvent [vector . size ()]; 
vector . copylnto ( evList ); 

} 

JtapiObjectNotif ier . getlnstance ( ) . enqueue ( IsList, evList ); 

} 
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/** 

* Returns the calling <code>Address</code> associated with this 

* <code>Call</code>. 
+ 

* ©return The calling <code>Address</code> associated with this 

* <code>Call</code>. 
*/ 

public final Address getCallingAddress ( ) 
{ 

return m_origAddress ; 



/** 

* Returns the calling <code>Terminal</code> associated with this 

* <code>Ca'll</code>. 
* 

* ©return The calling <code>Terminal</code> associated with this 

* <code>Call</code> . 
. */ 

public final Terminal getCallingTerminal ( ) 
{ - 
return m^origTerminal ; 



f * * 

* Returns the called <code>Address</code> associated with this 

* <code>Call</code>. 

* ©return The called <code>Terminal</code> associated with this 

* <code>Call</code>. 
*/ 

public final Address getCalledAddress ( ) 
{ 

return m destAddress; 



f * * 

* Drops the given <code>Call</code> 
* 

* @param opcode the code of operation, which was cause of the drop. 

* ©exception j avax . telephony . ResourceUnavailableExcept ion if an internal 

* resource necessary for the operation is unavailable. 

* ©exception j avax . telephony . PrivilegeViolationException if the 

* application does not have the proper authority to drop the telephone 

* call. 

* ©exception j avax . telephony . InvalidStateException if some object 

* required by this method is not in a valid state for this method. 

* ©exception j avax . telephony . MethodNotSuppbrtedException if the 

* implementation does not support this method. 

*/ 

protected void drop ( int opcode) 

throws InvalidStateException, MethodNot Support edExcept ion, 

PrivilegeViolationException, ResourceUnavailableExcept ion 

{ 

int meta = Ev.META CALL ENDING, cause = Ev. CAUSE CALL CANCELLED; 
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synchronized (m_id) 
{ 

synchronized ( m_connections ) 
{ 

int size = m^connections . size ( ) ; 

GenConnection conn; 

for (int i=0; i< size; i++) 

{ 

conn = (GenConnection) m__connections . elementAt ( i ) ; 
conn . disconnect (cause, meta, false, false, opCode); 

} 

m_connections . removeAHElement s ( ) ; 

} 

moveToState (Call . INVALID, cause, meta, true, opCode ); 
m^provider . removeCall ( this ) ; 

} 

} 

* Adds <code>CallObserver</code>s from the given array to this call. 

* If the given array is <code>null</code> this method fails silently, 

* i.e. no observers are added and no exception is thrown. 
* 

* <B>Post-Conditions : </B> 

* <0L> 

* <LI>each observer, from the observers array, is an element of 

* <code>this . getObservers ( ) </code> 

* <LI>A snapshot of events is delivered to each added observer. 

* </0L> 

* dparam observers The array of observers being added. 

* ^exception MethodNotSupportedException The observer cannot be added at this time 

* @exception ResourceUnavailableException The resource limit for the 

* numbers of observers has been exceeded. 
*/ 

public void addObservers (CallObserver [ ] observers) 

throws ResourceUnavailableException, MethodNotSupportedException 

if (null == observers) 
{ 

return; 

} 

for (int i=0; i< observers . length; i++ ) 
{ 

addObserver (observers [i] ) ; 

} 

} 

/* ★ 

* Adds <code>CallListener</code>s from the given array to this call. 

* If the given array is <code>null</code> this method fails silently, 

* i.e. no listeners are added and no exception is thrown. 
* 

* <B>Post-Conditions : </B> 

* <0L> 

* <LI>each listener, from the observers array, is an element of 

* <code>this . getCallListeners ( ) </code> 

* <LI>A snapshot of events is delivered to to each added listener. 

* </0L> 
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* @param listenera The array of listeners being added. 

* ©exception MethodNotSupportedException The listener cannot be added at 

* this time 

* ©exception ResourceUnavailableException The resource limit for the 

* numbers of listeners has been exceeded. 
*/ 

protected void addCallListeners (CallListener [ ] listeners) 

throws ResourceUnavailableException, MethodNotSupportedException 

{ 

if (listeners — null) 
{ 

return; 

} 

for (int i=0; i<listehers . length; i++) 
{ 

addCallListener (listeners [i] ) ; 

} 



/ * * 

* Removes association between this <code>GenCall</code> and the given 

* <code>GenConnection</code> object. 

* @param connection j avax . telephony . Connection 

* @param cause The given cause ID. 

* @param meta The given meta-code. 

* @param isNewMetaEv <code>true</code> if anotif ication event starts of 

* a new meta code group, <code>f alse</code> otherwise. 

* @param jtapiOnly <code>true</code> if the operation is done only in the 

* JTAPI layer, <code>f alse</code> if need update JTSPI too. 

* ©param opCode The given operation code. 
* 

* ©exception j avax . telephony . ResourceUnavailableException if an internal 

* resource necessary for the operation is unavailable. 

* ©exception j avax . telephony . PrivilegeViolat ionExcept ion if the 

* application does not have the proper authority to remove the connection 

* from the telephone call. 

* ©exception j avax . telephony . InvalidStateException if some object 

* required by this method is not in a valid state for this method. 

* ©exception j avax . telephony . MethodNotSupportedException if the 

* implementation does not support this. method. 
*/ 

public void removeConnection ( GenConnection connection, 

int cause, int meta, boolean isNew, 
boolean jtapiOnly, int opcode) 
throws PrivilegeViolat ionExcept ion, ResourceUnavailableException, 
MethodNotSupportedException, InvalidStateException 

{ 

if ( null == connection) 
{ 

throw new IllegalArgumentException ( "connection is null"); 

} 

synchronized (m_id) 
{ 

if( m_connections . removeElement ( connection ) ) 
{ 

int obMeta = (0 == meta ) ? Ev . META_CALL_REMOVING_PARTY : meta;. 
connection . disconnect (cause, obMeta, isNew, jtapiOnly, opCode); 
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if( m_connections . size ( ) < 2 ) 
{ 

drop ( opCode ) ; 

} 

int otherLocals = 0; 
if( isFirstParty ( ) ) 
{ 

f or ( int i=0; i < m_connect ions . size () ; i++ ) 
{ 

if ( ( (GenConnection ) m_connect ions . elementAt (i) ) .isLocal ( ) ) 
« 

otherLocals++ ; 

} 

} 

if( (getStateO != Call . INVALID) && ( 0 == otherLocals )) 
{ 

drop ( opCode ) ; 

} 

} 

} 

} 

} 

* Disconnects the part ( leg ) of the call. 

* If the <code>Call</code> doesn't have the part, this method fails 

* silently, i.e. no part is disconnected and no exception is thrown. 
* 

* <B>Pre-conditions : <B> 

* <OL> 

* <LI>this.getProvider () .getState () == Provider . IN_SERVICE 

* <LI>Let Connection c = this . getConnection ( addr); 

* <LI>Let TerminalConnection tc[] = c . getTerminalConnections (see post- 

* conditions ) 

* </OL> 

* <B>Post-Conditions : </B> 

* <OL> 

* <LI>this.getProvider() .getState () == Provider . IN_SERVICE 

* <LI> c.getState() == Connection . DISCONNECTED 

* <LI>For all i, tc [ i ]. getState ( ) TerminalConnection . DROPPED 

* <LI>c . getTerminalConnections ( ) == null. 

* <LI>c is not an element of this . getConnections ( ) 

* <LI><code>ConnectionEvent . ConnectionDisconnected</code> / 

* <code>ConnDisconnectedEv</code> events are delivered for the disconnected 

* Connection. 

* <LI><code>TerminalConnectionEvent . TerminalConnectionDropped</code> / 

* <code>TermConnDroppedEv</code> events are delivered for all 

* <code>TerminalConnection</code>s associated with the disconnected Connection. 

* <LI><code>.ConnectionEvent . ConnectionDisconnected</code> / 

* <code>TerminalConnectionEvent . TerminalConnectionDropped</code> ; 

* <code>ConnDisconnectedEv</code> / <code>TermConnDroppedEv</ code> events are 

* delivered for all other Connections and TerminalConnections dropped 

* indirectly as a result of this method. 

* <LI><code>CallEvent . CallInvalid<code> / <code>CallInvalidEv</code>, if all 

* Connections are dropped indirectly as a result of this method. 

* </OL> 

* @param addr The disconnected party address name. 

* @param state The given state value. 
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* @param cause The given cause ID. 

* @param meta The given meta-code. 

* @param opCode The operation code. 

*/ 

void disconnectPart (String addr, String term, int cause, int opCode) 
{ 

GenConnection conn = getConnection ( addr ); 

if (null == conn ) 

{ 

return; 

} 

int meta = Ev . META_CALL_REMOVING_PARTY; 

try 

{ 

if ( null — term ) 
{ 

// Connection removing 

removeConnection ( conn, cause, meta, true, true, opCode ); 

} 

else 
{ 

// TerminalConnection removing 

GenTerminalConnection tconn = conn . getTerminalConnection ( term) ; 

if ( null == tconn ) 

{ 

throw new IllegalArgumentException ( 

"the call doesn't have connection with" 
+ " specified address and terminal"); 

} 

conn . removeTerminalConnection ( tconn, cause, meta, 

true, true, opCode) ; 

} 

} 

catch (Exception e) 
{ 

GenJtapiPeer .ms_log . warningMessage ( "GenCall : disconnectPart: " + e) ; 

} 

} 

/** 

* Returns <code>GenConnection</code>, associated with this 

* <code>GenCall</code> and connected to the <code>GenAddre s s < / code > with 

* the given name. The <code>null</code> will be returned if this connection 

* cannot be found. 
* 

* @param addrName the needed connection address name. 

* @return <code>GenConnection</code> associated with this 

* <code>GenCall</code>, and with <code>GenAddress</code> which has hiven 

* name, or <code>null</code> . 
*/ 

public GenConnection getConnection ( String addrName) 
{ 

Address address; 
synchronized (m__connections ) 
{ 

int size = m_connections . size ( ) ; 
for ( int i = 0; i < size; i++ ) 
{ 
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GenConnection conn = (GenConnection) m_connections . elementAt (i ) ; 

address = conn . getAddress ( ) ; 

if ( address . getName (). equals ( addrName ) ) 

{ 

return conn; 

} 

} 

return null; 

} 

} 

+ Returns <code>GenTerminalConnection</code>, associated with one of this 

* <code>GenCall</code> connections and connected to the given 

* <code>Terminal</code> . 

* <p> 

* The <code>null</code> will be returned if this 

* <code>GenTerminalConnection</code> cannot be found. 

* @param terminal the needed TerminalConnection terminal. 

* @return <code>GenTerminalConnection</code> associated with one of this 

* <code>GenCall</code> connections, and with given <code>Terminal</code>, 

* or <code>null</code> . 
*/ 

public GenTerminalConnection getTerminalConnection ( Terminal terminal) 
{ 

if ( null == terminal ) 
{ 

return null; 

} 

// TBD what about several terminalConnect ions to the same termianl? 

for(int i=0; i<m__connections . size { ) ; i++) 

{ 

TerminalConnection [ ] tc = ( (Connection) m_connections . elementAt ( i ) ) 
■ < ■ • . getTerminalConnections ( ) ; 

f or ( int j=0; j<tc. length; j++) 
{ 

if( terminal . equals (tc [j ]. getTerminal () ) ) 
{ 

return (GenTerminalConnection) tc [ j ] ; 

} 

} 

} 

return null; 



/ * * 

* Informs the call that the destination Connection was connected. 

* According to <code>Call . connect () </code> operation: 

* "The destination <code>Connection<code> moves into the 

* <code>Connection. CONNECTED</code> state when the called party answers 

* the telephone call. If the destination Terminals are known, the answering 

* <code>TerminalConnection<code> moves into the 

* <code>TerminalConnection . ACTIVE</code> state . 

* <p> 

* <B>Events delivered to the application : </B> 

* a <code>ConnectionEvent . CONNECTION_CONNECTED<code> / 

* <code>ConnConnectedEv</code> for the destination <code>Connection</code> 

* and a <code>TerminalConnectionEvent . TERMINAL CONNECTION ACTIVE</code> / 
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* <code>TermConnActiveEv</ . code> for the answering 

* <code>TerminalConnection</code>, if known. 



@param remAddr - name of the remote address. 
@param remTerm - name of the remote terminal. 
*/ 

protected synchronized void connected! String remAddr, String remTerm ) 
{ 

// get destination connection [INPROGRESS I ALERTING] 
GenConnection connection = getConnection ( remAddr ); 
if ( null == connection ) 
{ 

throw new IllegalArgumentException ( "connection not found" ) ; 

} 

if (connection. getState ( ) != Connection . INPROGRESS && 
connection . getState ( ) != Connection . ALERTING) 

{ 

return; 

} 

// get destination terminal connection 

GenTerminalConnection termConnection = 

connection . getTerminalConnect ion ( remTerm) ; 
int observMeta = E v . META__CALL_S TART I NG , observCause = Ev . CAUSE_NORMAL ; 
if ( connection. getState () == Connection . INPROGRESS ) 
{ 

// terminal connection may not exist or be IDLE 

if( null == termConnection ) 

{ 

// create destination terminal 

GenProvider provider = (GenProvider ) get Provider () ; 
JtapiObjectCreator creator = provider . getObj ectCreator () ; 
GenTerminal terminal = creator . createRemoteTerrninal ( 

provider, connection . getProviderPlugin () , remTerm); 
// create terminal connection 

termConnection = creator . createTerminalConnection ( 

terminal, connection, 
observCause, observMeta, false ) ; 

} 

// move new terminal connection to RINGING state 

termConnection . moveToState (TerminalConnection . RINGING, observCause, 

observMeta, false, CoreOperations . CONNECTED_CB) ; 
// move remote connection to ALERTING state 

connection . moveToState (Connection . ALERTING, observCause, observMeta, 

false, CoreOperations . CONNECTED_CB) ; 

} 

// move terminal connection to ACTIVE state 
termConnection. moveToState ( TerminalConnection . ACTIVE, observCause, 

observMeta, false, CoreOperations . CONNECTED_CB) ; 

// move connection to CONNECTED state 

//connection .moveToState ( Connection . CONNECTED, observCause, observMeta, 

false, 

// 

CoreOperations . CONNECT ED_CB) ; 

// move all connections to CONNECTED state, need for extending packages. 

for (int i=0; i< m_connect ions . size () ; i++ ) 

{ 
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( (GenConnection) m_connections . elementAt (i) ) . 

moveToState ( Connection . CONNECTED, observCause, 
observMeta, false, 
CoreOperations . CONNECTED_CB) ; 



/ * * 

* Informs the call that its local connection is offering. 

* @param local Address local address 

* @param remAddrName calling address 

* @param remTermName calling terminal 

* loopback <code>true</code> if the local and remote addresses belong to 

* the same provider, <code>f alse</code> otherwise. 

* @param plug the <code>ProviderPlugin</code> which get the incoming call. 
*/ 

protected void offering ( GenAddress localAddress , String remAddrName, 

String remTermName, boolean loopback, 
ProviderPlugin plug) 

{ 

try 
{ 

addObservers (localAddress . getCallObservers ( ) ) ; 
addCallListeners ( localAddress . getCallListeners ( ) ) ; 

GenTerminal [ ] terminals = (GenTerminal []) localAddress . getTerminals () ; 

if ( null != terminals ) 

{ 

for(int i=0; i< terminals . length; i++) 
{ 

addObservers (terminals [i] . getCallObservers ( ) ) ; 
addCallListeners ( terminals [ i] . getCallListeners ( ) ) ; 

} 

} 

int observCause = Ev . CAUSE_NEW_CALL, observMeta = Ev. META_CALL_STARTING; 
moveToState (Call .ACTIVE, observCause, observMeta, true, 

CoreOperations . OFFERING_CB ) ; 
JtapiObjectCreator creator = m_provider . getObj ectCreator ( ) ; 
GenConnection localConnection, remoteConnection; 
if ( loopback ) 
{ - 

localConnection = getConnection ( localAddress . getName ( ) ); 

if ( null == localConnection ) 

{ 

localConnection = creator . createConnect ion ( this, 

localAddress, observCause, observMeta, false) ; 

} 

remoteConnection = getConnection ( remAddrName ); 

remoteConnection. moveToState ( Connection . INPROGRESS, observCause, 
observMeta, false, CoreOperations . OFFERING_CB) ; 

} 

else 
{ 

GenAddress remoteAddress = 

creator . createRemoteAddress (m_provider, plug, remAddrName) ; 
GenTerminal remoteTerminal = 

creator . createRemoteTerminal (m_provider, plug, remTermName); 
remoteAddress . addTerminal (remoteTerminal) ; 
setOriginatingEndpoint (remoteAddress, remoteTerminal) ; 
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localConnection = creator . createConnection ( this, 

localAddress, observCause, observMeta, false); 
remoteConnection = creator . createConnection ( this, 

remote Address, observCause, observMeta, false) ; 

remoteConnection .moveToState ( Connection . INPROGRESS, 

observCause, observMeta, false, 
CoreOperations . OFFERING_CB) ; 

GenTerminalConnection remTermConnect ion = 

creator . createTerminalConnection ( remoteTerminal , remoteConnection, 

observCause, observMeta, false) ; 
remTermConnect ion. moveToState ( TerminalConnection .ACTIVE, 

observCause, observMeta, false, 
CoreOperations . OFFERING_CB) ; 

} 

remoteConnection. moveToState ( Connection . CONNECTED, observCause, 

observMeta, false, 
CoreOperations . OFFERING_CB) ; 
localConnectionOf f ering ( localConnection) ; 
} catch (Exception e) 
{ 

// TBD need roolback 

GenJtapiPeer . ms_log . errorMessage { "GenCall: offering: " + e ); 

} 

} 

/ * * 

* Informs the <code>GenCall</code> that distination part is ringing. 

* The destination <code>Connection</code> moves into the 

* <code>Connect ion .ALERT ING</code> state . 

* <code>TerminalConnection</code> object may be created to model 

* the relationship between any known destination Terminals associated with 

* the Call, each in the <code>TerminalConnection . RINGING</code> state. 

* If the destination Terminals are unknown , then no TerminalConnections are 

* created. 

* <p> 

* <B>Events delivered to the application : </B> 

* a <code>ConnectionEvent . CONNECTION_ALERTING</ code> / 

* <code>ConnAlertingEv</code> for the destination <code>Connect ion</code>, 

* a <code>TerminalConnectionEvent . TERMINAL_CONNECTION_CREATED</code> / 

* <code>TermConnCreatedEv</code> and 

* <code>TerminalConnectionEvent . TERMINAL_CONNECTION_RINGING</code> / 

* <code>TermConnRingingEv</code> for 

* any destination TerminalConnections created. 

* @param addrName name of distination address 

* @param termName name of distination terminal, may be <code>null</code> 
*/ 

protected void ringing ( String addrName, String termName) 
{ 

// synchronize the operation 

int meta = Ev . META_CALL_STARTING, cause = Ev . CAUSE_NORMAL; 

synchronized ( m_id ) 

{ 

// get remote connection [IDLE | INPROGRESS] 

GenConnection connection = getConnection ( addrName ); 

if ( null == connection ) 

{ 
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throw new IllegalArgumentException ( "connection not found" ); 

} 

// get remote terminal connection 

if( null ! = termName) 

{ 

GenTerminalConnection termConnection = 

connection . getTerminalConnection ( termName) ; 
if( null == termConnection ) 
{ 

JtapiObjectCreator creator = m_provider . getObj ectCreator ( ) ; 
// create destination terminal 
GenTerminal term = null; 

if( m_provider . isLocalTerminal ( termName ) ) 
{ 

try 
{ 

term = 

(GenTerminal ) m_provider . getTerminal ( termName ) ; 

} 

catch (InvalidArgumentException e) 
{ 

// we cannot be here 

GenJtapiPeer .ms_log . warningMessage ( "GenCall . ringing: " , e) ; 

•v . } 
} 

else 
{ 

term = creator.createRemoteTerminal (m_provider, 

connection . getProviderPlugin ( ) 7 termName 

) ; 

} 

// create terminal connection 

termConnection = creator . createTerminalConnection ( term, 

connection, cause, meta, false ) ; 

} 

// move terminal connection to RINGING state 
termConnection . moveToState ( TerminalConnection . RINGING, 

cause, meta, false, 
CoreOperations . RINGING__CB) ; 

} 

// move objects to correct states 

// move connection to ALERTING state 

connection .moveToState ( Connection . ALERTING, cause, 

meta, false, CoreOperations . RINGING_CB) ; 
synchronized ( m_connections ) 
{ 

int size = m__connections . size ( ) ; 

GenConnection conn; 

for (int i=0; Ksize; i++) 

{ 

conn = (GenConnection) m_connections . elementAt ( i ) ; 

if( ! conn . equals (connection) ) 

{ 

conn. moveToState (Connection . CONNECTED, 

cause, meta, false, CoreOperations . RINGING_CB) ; 

} 

} 
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} 

} 



} 

/ + * 

* Part of offering operation. The method is overwrited by the extend package. 
*/ 

protected void localConnectionOf f ering ( GenConnection connection) 
{ 

Address localAddress = connection . getAddress () ; 

GenTerminal [ ] terminals = (GenTerminal []) localAddress . getTerminals () ; 
int observCause = Ev . CAUSE_NEW_CALL / observMeta = Ev . META__CALL_STARTING; 
GenTerminalConnection [ ] localTermConnections = 

new GenTerminalConnection [terminals . length] ; 

JtapiObjectCreator creator - m__provider . getObj ectCreator { ) ; 

for (int i=0; Kterminals . length; i++) 

{ 

localTermConnections [i] = 

creator . createTerminalConnection ( terminals [i] , 

connection, observCause, observMeta, false ) ; 
localTermConnections [i] .moveToState ( TerminalConnection . RINGING, 

observCause, observMeta, false, 
CoreOperat ions . OFFERING__CB) ; 

} 

connection .moveToState ( Connection . ALERTING, observCause, 

observMeta, false, 
CoreOperations.OFFERING_CB) ; 

} 



/ * * 

* Sets parameters of the originating endpoint for this <code>Call</code> . 

* @param origAddress The given originating <code>Address</code> . 

* Qparam origTerminal The given originating <code>Terminal</code> . 
*/ 

protected void setOriginatingEndpoint ( GenAddress address, 

GenTerminal terminal) 

{ 

m_origAddress = address; 
m_origTerminal = terminal; 



/ * * 

* Delivers the <code>CallObservationEndedEv</code> event to a given 

* <code>CallObserver</code> object, which has been removed from this 

* <code>GenCall</code> . 

* @param observer The given <code>CallObserver</code> which has been 

* removed. 
*/ 

protected void notif yObserverRemoved ( CallObserver observer ) 
{ 

CallObserver [ ] obList = { observer } ; 

CallEv[] evList = { new GenCallObservationEndedEv ( this ) }; 
JtapiObjectNotif ier . getlnstance (). enqueue ( obList, evList ); 
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} 



/ + * 

* Delivers the <code>CallEvent . CALL_EVENT_TRANSMISSION_ENDED</code> 

* event to a given <code>CallListener</code> object, which has been 

* removed from this <code>GenCall</code> . 
* 

* @param listener The given' <code>CallListener</code> which has been 

* removed. 
*/ 

protected void notif yListenerRemoved (CallListener listener) 
{ 

CallListener [ ] IsList = { listener }; 
CallEvent[] evList = { new GenCallEvent ( this , 

CallEvent . CALL_EVENTJTRANSMISSION_ENDED, CallEvent . CAUSE_UNKNOWN ) 
JtapiObjectNotif ier . getlnstance ( ) . enqueue ( IsList, evList ); 

} 

/ -k * 

* Adds the given <code>Connection</code> to this <code>GenCall</code> . 
* 

* @param connection The added Connection. 
*/ 

protected void addConnection (Connection conn) 
{ 

synchronized (m^connections ) { 

if (null == conn j | m_connections . contains (conn) ) 
{ 

return; 

} 

m_connections . addElement ( conn) ; 

} 

} 

protected void finalize () throws Throwable 
{ 

//notify all observers 

CallObserver [ ] obList = getObservers () ; 

CallEv[] evList = { new GenCallObservationEndedEv ( this ) }; 
JtapiObjectNotif ier . getlnstance (). enqueue ( obList, evList ); 
m_observers . removeAHElements ( ) ; 
//notify all listeners 

CallListener [ ] IsList = getCallListeners ( ) ; 
CallEvent [] eventsList = { 
new GenCallEvent (this, 

CallEvent . CALL_EVENT_TRANSMISSION_ENDED, 
CallEvent . CAUSE_UNKNOWN) }; 
JtapiObjectNotif ier . getlnstance (). enqueue ( IsList, eventsList ); 
m^listeners . removeAHElements ( ) ; 
super . finalize ( ) ; 
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package com. ibm. hrl . j tapi ; 



* (c) Copyright IBM Corporation 1998,1999 

* IBM Research Laboratory in Haifa 

* Generic JTAPI Implementation (JTAPI 1.2 / JTAPI 1.3) 



* Package 

* Class 

* Created 
*/ 



com . ibm . hrl . j tapi 
Gen Jtapi Peer 



import java . util . Properties; 
import java . util . Enumeration; 
import j ava . util . StringTokenizer; 
import j ava . util . Hasht able; 
import j ava . util . Vector ; 

import j ava . io . FilelnputStream; 
import j ava . io . FileNotFoundException; 
import j ava . io . IOException; 

import javax. telephony . * ; 

import com. ibm. hrl . j tapi . j tspi . ProviderPlugin; 
import com. ibm. hrl . j tapi . j tspi . CallControlProviderPlugin; 
import com . ibm. hrl . j tapi . j tspi . CallCenterProviderPlugin; 
import com. ibm. hrl . j tapi . j tspi . Media ProviderPlugin; 

import com . ibm. hrl . j tapi . util . JtapiObj ectCreator ; 
import com. ibm . hrl . util . SystemLog; 
import com. ibm. hrl . util . DebugLog; 

/* * 

* Generic implementation of the 

* JtapiPeer interface. 
* 

* @see javax . telephony . JtapiPeer 

* @see com. ibm. hrl . j tapi . GenProvider 

* @author Alexey Roytman 
*/ 

public class GenJtapiPeer implements JtapiPeer 
{ 



// IBM Copyright 

public static final String IBM_Copyright = Copyright . SHORT_STRING ; 
/* 

* Configuration file, with following (properties) format: 

* service = fileName. 

* Where service is name one of the peer services and 

* fileName is name of the service configuration file. 
*/ 

private static String ms_conf igFileName - "gen j tapi . cfg" ; 

private static String ms_addressString = "address."; 

private static char ms_delimeter = 1 ; 1 ; 
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private static String ms_eventsViewable 



= "GenJtapiEventsViewable" ; 



* Hashtable of created providers . 

* keys: strings from get ProviderMethod 

* values: created providers 
*/ 

private static Hashtable providers; 



/* 

* Possible services and corresponding configuration file names 
* 

* key - service name 

* data - configuration file name 
*/ 

private Properties m_services; 

// We can use it from all parts of the program 
// The PROGRESS_3 logger reserved for events 
static public DebugLog ms_log; 

// ctors 

static { 

// should be changed for MOBILE 
ms_log = new SystemLog ( ) ; 

ms_log. setLogEnabled ( DebugLog . ERROR | DebugLog . WARNING | 

DebugLog . PROGRESS , true ) ; 
providers — new Hashtable ( ) ; 

} 

/** 

* The default <code>GenJtapiPeer</code> constructor. 

* Initializes the Services properties. 
* 

* ^exception j avax . telephony . JtapiPeerUnavailableException if the 

* GenJTAPI Peer Toolkit cannot be initialized. 
*/ 

public GenJtapiPeer ( ) throws JtapiPeerUnavailableException { 



try { 

// read from configuration file into Properties object 
m_services = new Properties ( ) ; 

FilelnputStream fs = new FilelnputStream (ms_conf igFileName ) ; 
m_services . load ( f s ) ; 
f s . close ( ) ; 
} catch (FileNotFoundException fe) { 

ms_log . errorMessage ( "Cannot found the " + ms_conf igFileName + 

" file"); 

throw new JtapiPeerUnavailableException ( fe . getMessage ()) ; 
} catch ( IOExcept ion ioe) { 

ms_log . errorMessage ( "Cannot load configuration properties", ioe); 
throw new JtapiPeerUnavailableException ( ioe . getMessage ()) ; 

> 

} 
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// JTAPI methods 



* Returns the full class name of this <code>JtapiPeer</code> instance. 

* <p> 

* This method implements the 

* <code> j avax . telephony . JtapiPeer . getName ( ) </code> method . 
* 

* ©return The full class name of this <code> JtapiPeer</code> instance. 
* 

* ©see javax . telephony. JtapiPeer . getName ( ) 
*/ 

public String getName ( ) { 

return getClass (). getName () ; 

} 

/* * 

* Returns <code>Provider</code> object given a string argument which contains 

* the desired service specification. If <code>Provider</code> with given 

* the string argument was created, next calls the method with the <b>same</b> 

* argument return the references to the same object.<br> 

* Note: may be we need compare ' formated string argument. 

* <p> 

* This method implements the 

* <code>j avax . telephony. JtapiPeer . getProvider ( ) </code> method. 

* <p> 

* The <code>providerString</code> argument has the following format: 

* <br><code>service__name; argl— vail; ...</code> 

* <br> where <code>service_name</code> is mandatory and each optional 

* argument pair which follows is separated by a semi-colon. 

* <p> 

* Possible argument names are as follows: 

* <ul> 

* <li><code>login</code> - provides the login user name to the 

* <code>Provider</code> 

* <lixcode>passwd</code> - provides a password to the <b>Provider</b> 

* <li>other optional arguments. 

* </ul> 

* All arguments are passed to the specific implementation of the 

* <code>ProviderService</code> object. 

* <p> 

* If the <code>providerString</code> argument is <code>null</code>, this method 

* returns the default <code>Provider</code> as determined by the 

* <code>GenJtapiPeer</code> implementation. 

* <p> 

* <B>Post-conditions : </B> 

* <OL> 

* <LI>this. getProvider () . getState ( ) == Provider . OUT_OF_SERVICE 

* </0L> 

* ©return The desired instance of the <code>Provider</code> object. 
* 

* ©param providerString Specification of the desired service. 
* 

* ©exception javax .'telephony . ProviderUnavailableException indicates a 

* <code>Provider</code> corresponding to the given string is unavailable. 
* 

* ©see javax . telephony . JtapiPeer . getProvider ( ) 
*/ 

public Provider getProvider ( String providerString ) 
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throws ProviderUnavailableException { 



ms_log . progressMessage ( " JtapiPeer . get Provider ( " + 

providerString + ")"); 
if ( null == providerString ) { 

throw new ProviderUnavailableException ( 

"Meantime we don't support default provider"); 

} 

ms_log . progressMessage ( " \nJtapiPeer . getProvider ( before synchronized in 

"); 

synchronized ( providers ) { 

ms_log .progressMessage ( "XnJtapiPeer . getProvider ( synchronized in "); 
// TBD if this is right?? 

if (providers . containsKey (providerString) ) { 

return ( Provider ) 'providers . get (providerString) ; 

} 

ProviderSpec spec = parseProviderString ( providerString ) ; 
Hashtable providerTable = new Hashtable () ; 

int level = initPlugins ( (String) m_services . get ( spec . name ) , 

spec . init Data, providerTable); 
if ( providerTable . size ( ) == 0) { 

ms_log . errorMessage ( "JtapiPeer : cannot initialize any plugin, 

bye ! " ) ; 

throw new ProviderUnavailableException ( "cannot initialize any 

plugin" ) ; 

} 

ms_log . progressMessage ( "JtapiPeer: we work with level " + level); 

JtapiObjectCreator creator = new JtapiObj ectCreator ( level ) ; 

Provider provider = creator . createProvider ( spec. name, providerTable, 

this); 

providers . put (providerString, provider) ; 

ms_log .progressMessage ( " \n JtapiPeer . get Provider ( synchronized out ") 
return provider; 

} 



f * * 

* Returns the services that this implementation supports. 

* <p> 

* This method implements the 

* <code>javax . telephony . JtapiPeer . getServices () </code> method. 

* @return The services that this implementation supports. 
★ 

* @see javax. telephony . JtapiPeer . 
*/ 

public String [] getServices () { 

String [] services = new String [m__services . size ()] ; 
Enumeration e = m_services . keys ( ) ; 
f or ( int i=0; e . hasMoreElements ( ) ; i++) { 
services [i] = ( String) e . nextElement () ; 

} 

return services; 



// Implementation methods 
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* Parses a given provider string and puts specifications of the desired 

* service provider to the <b>ProviderSpec</b> structure. 
* 

* ©return The resulting service provider specifications. 

* @param providerString The given provider string. 
* 

* ©exception javax. telephony . ProviderUnavailableException indicates the 

* service name is not specified in the provider string. 
*/ 

private ProviderSpec parseProviderString ( String providerString ) 
throws ProviderUnavailableException { 

ProviderSpec provSpec = new ProviderSpec () ; 

StringTokenizer list = new StringTokenizer ( providerString, ";" ); 
while ( list . hasMoreTokens ( ) ) { 

String token = list . nextToken ( ) ; 
if ( null == provSpec . name ) { 

// the first token should be 'service_name' 
provSpec . name = token . trim () ; 
} else { 

// put the "tag = value" pair 

if ( null == provSpec . initData ) { 

provSpec . initData = new Properties () ; 

} 

int index = token . indexOf ( 1=1 ); 
if ( index > 0 ) { 

String' key = token . substring ( 0, index ).trim(); 
if{ key. length () > 0 ) { 

String value — token . substring ( index + 1 ) . trim ( ) ; 
if( value . length ( ) > 0 ) 

provSpec . initData . put ( key, value ); 

} 

■ } 

} 

} 

if ( null == provSpec . name II ! m_services . containsKey (provSpec . name ) ) { 
throw new ProviderUnavailableException ( 

ProviderUnavailableException. CAUSE_INVALID_SERVICE, 
"invalid service specification" ) ; 

} 

return provSpec; 



// private container class 
private class ProviderSpec { 

String name; 

Properties initData; 

} 

protected int initPlugins ( final String cnfFileName, 

final Properties initData, 

Hashtable pluginsTable ) { 

Properties pluginsProp = new Properties () ; 
try { 

FilelnputStream fs = new FilelnputStream ( cnfFileName ) ; 
pluginsProp . load ( f s ) ; 
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f s . close ( ) ; 
} catch ( Exception e) { 

ms_log . errorMessage ( "Gen JtapiPeer : initPlugins : ", e) ; 
System. exit (1) ; 

} 

Enumeration pluginsEnum = pluginsProp . keys () ; 

// Hashtable with . keys: - plugins objects, data: - hashtable2 

// Hashtable2 keys: addresses 1 names, data: - array of assosiated terminals* 

names 

int level = 0; 

while (pluginsEnum. hasMoreElements ( ) ) { 

String plugName = { String) pluginsEnum . nextElement () ; 
String plugData = pluginsProp . get Property (plugName ) ; 
int delimlndex = plugData . indexOf (ms_delimeter ) ; 
if ( 1 > delimlndex I | delimlndex == (plugData . length ( ) - 1)) { 
continue; 

} 

try { 

Class pluginClass = Class . forName (plugData . substring ( 0 , delimlndex)); 
ProviderPlugin plugin = { ProviderPlugin) pluginClass . newlnstance () ; 
. Properties plugResources = new Properties ( ) ; 
FilelnputStream fs. = new FilelnputStream ( plugData . substring (delimlndex 

+ D); 

plugResources . load ( fs ) ; 
f s . close ( ) ; 

Enumeration resourcesEnum = plugResources . keys () ; 
Hashtable addressTerm = new Hashtable () ; 
while (resourcesEnum. hasMoreElements ( ) ) { 

String resourceName = ( String) resourcesEnum. nextElement () ; 

if ( resourceName . startsWith (ms_addressString) ) { 
Vector terminalsVector = new Vector ( ) ; 

String termList = plugResources . get Property ( resourceName ) ; 
plugResources . remove ( resourceName ) ; 
int delim, lastDelim = 0; 

while ( lastDelim < termList . length ( ) ) { 

delim = termList . indexOf (ms_delimeter / lastDelim); 
if ( -1 != delim) { 



terminalsVector . addElement (termList . substring (lastDelim, delim) ) ; 

lastDelim = delim + 1; 
} else { 

terminalsVector . addElement (termList . substring (lastDelim) ) ; 

lastDelim = termList . length () ; 

} 

} 

if{0 == terminalsVector . size () ) { 
continue ; 

} 

String [] terminalsArray = new String [ terminalsVector . size ()] ; 
terminalsVector. copylnto (terminalsArray) ; 

addressTerm. put (resourceName . substring (ms_addressString . length ( ) ) , terminalsArray) ; 

} 

} 

if(0 == addressTerm. size () ) { 
continue; 

} 

if( null != initData ) { 



6 



resourcesEnum = initData . keys ( ) ; 

while (resourcesEnum. hasMoreElements () ) { 

String propert = ( String) resourcesEnum. nextElement () ; 

plugResources .put (propert, initData. get (propert) ) ; 

} 

} 

if ( plugResources . containsKey (ms_event sViewable ) ){ 
Boolean b = new 
Boolean { (String) plugResources . get (ms_event sViewable ) ) ; 

boolean viewEvents = b . booleanValue ( ) ; 

ms_log. setLogEnabled ( DebugLog. PR0GRESS_3, viewEvents) ; 
plugResources . remove (ms_eventsViewable ) ; 

} 

plugin.prvlnitialize (addressTerm, plugResources) ; 

level |= checkSupportedLevel (plugin) ; 
// updateCapabilities (plugin) ; 

pluginsTable . put (plugin, addressTerm) ; 
} catch (Exception e) { 

ms_log. warningMessage ( "Gen JtapiPeer : initPlugins : " , e) ; 
// We don't use the plugin 
} 

} 

return level; 

} 

protected int checkSupportedLevel { ProviderPlugin plugin) { 
int level = plugin . prvSupportedLevel () ; 

if((0 != (level & ProviderPlugin . CALLCONTROL_LEVEL) ) && 
! (plugin instanceof CallControlProviderPlugin) ) { 
level &= -Provider Plugin. CALLCONTROL_LEVEL; 
} else if (( 0 != (level & ProviderPlugin . CALLCENTER_LEVEL) ) && 
! (plugin instanceof CallCenterProviderPlugin ) ) { 
level &= -ProviderPlugin. CALLCENTER_LEVEL; 
* } else if ((0 != (level & ProviderPlugin . MEDIA_12_LEVEL) ) && 
! (plugin instanceof MediaProviderPlugin) ) { 
level &= -ProviderPlugin. MEDIA_12_LEVEL; 

} 

return level; 

} 
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package com. ibm. hrl . j tapi . j tsmi ; 
/* 

* (c) Copyright IBM Corporation 1998,1999,2000 

* IBM Research Laboratory in Haifa 

* Generic JTAPI Implementation (JTAPI 1.3) 



* Created : ^ ^^mg^ Sf 

*/ 

import j ava . util . Properties ; 
import java . util . Hashtable; 

public interface JtsmiPlugin 
{ 

public void init ( String ruleFile, Properties initData ); 

public String addressConvert ( String address ); 

public String pluginForAddress ( String address ) ; 

public boolean isInService( Hashtable providerPluginStates ) 



* Package 

* Class 



com. ibm. hrl . j tapi . j tsmi 
JtsmiPlugin 




-} 
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package com. ibm. hrl . j tapi . j tsmi; 



* (c) Copyright IBM Corporation 1998, 1999, 2000 

* IBM Research Laboratory in Haifa 

* Generic JTAPI Implementation (JTAPI 1.3) 



Package 

Class 

Created 



com. ibm. hrl . j tapi . j tsmi 
MultyPluginJTSMI 



import java . util . Hashtable'; 
import java . util . Enumeration; 
import j ava . util . Properties ; 
import java . util . Vector ; 

import java . io . FilelnputStream; 
import java . io . FileNot FoundException; 
import j ava . io . IOException; 



import j avax . telephony .Address ; 

import j avax . telephony . Provider ; 

import j avax . telephony . Terminal ; 

import j avax . telephony . Call ; 

import j avax . telephony . ResourceUnavailableException; 

import j avax . telephony . InvalidArgumentException; 

import j avax . telephony . Plat f ormException; r 

import com. ibm. hrl . j tapi . GenAddress; 
import com . ibm . hrl . j tapi . GenTerminal ; 
import com. ibm. hrl . j tapi . GenProvider ; 
import com. ibm. hrl . j tapi . GenJtapiPeer ; 
import com. ibm. hrl . j tapi . GenConnection; 



import com. ibm. hrl . j tapi . capabilities . GenAddressCapabilities ; 

import com. ibm. hrl . j tapi . capabilities . GenCallCapabilities ; 

import com. ibm. hrl . j tapi . capabilities . GenConnect ionCapabilit ies ; 

import com. ibm. hrl . j tapi . capabilities . GenProviderCapabilit ies ; 

import com. ibm. hrl . j tapi . capabilities . GenTerminalCapabilities ; 

import com . ibm . hrl . j tapi . capabilities . GenTerminalConnect ionCapabilit ies ; 

import com. ibm. hrl . jtapi . util . JtapiOb j ectCreator ; 

import com. ibm. hrl . j tapi . jtspi . JtapiCallbacks; 
import com. ibm. hrl . jtapi . jtspi . ProviderPlugin; 

public class MultyPluginJTSMI extends Jtsmi 
{ 

// IBM Copyright 

public static final String IBM_Copyright = Copyright . SHORTJSTRING; 

public static String ms_jtsmiName = " JtsmiPlugin" ; 

// providers 1 plugins objects 
// key - plugin name 
// value - plugin object 
private Hashtable m_plugins; 
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// plugin's states 

// key plugin object 

// value Boolean state 

private Hashtable m^pluginStates; 

// key - addressName 

// valuse terminal name array. 

private Hashtable m_resources; 

private JtsmiPlugin m_j tsmiPlugin; 

private static Boolean ms_inService = new Boolean ( true ) ; 
private static Boolean ms_outOf Service = new Boolean { false ); 



public MultyPluginJTSMI ( Properties pluginsProp, Properties initData ) 

{ 

m_resources = new Hashtable (); 
m_plugins = new Hashtable ( 3 ) ; 
m_pluginStates — new Hashtable ( 3 ) ; 
dolt ( pluginsProp, initData ) ; 

} 

private synchronized void dolt ( Properties pluginsProp, final Properties initData 

) 

{ 

Enumeration pluginsEnum = pluginsProp . keys () ; 
int runningThreads = 0; 
final Vector plugins = new Vector {) ; 
while (pluginsEnum. hasMoreElements ( ) ) 
{ 

final String plugName — ( String) pluginsEnum . nextElement () ; 

String plugData = pluginsProp . getProperty (plugName) ; 

int delimlndex = plugData . indexOf (ms_delimeter) ; 

if( 1 > delimlndex | | delimlndex == (plugData . length ( ) - 1)) 

{ 

continue; 

} 

final ProviderPlugin plugin; 
final String resourceFile; 
try 

{ • 

Class pluginClass = Class . forName (plugData . substring ( 0 , delimlndex)); 

if( plugName . equals (ms_j tsmiName ) ) 

{ 

m_j tsmiPlugin = ( JtsmiPlugin) pluginClass . newlnstance () ; 

m_j tsmiPlugin . init ( plugData . substring ( delimlndex +1), initData ); 

continue; 

} 

plugin = ( ProviderPlugin) pluginClass . newlnstance () ; 
resourceFile = plugData . substring (delimlndex +1); 

} 

catch (Exception e) 
{ 

GenJtapiPeer .ms_log. warningMessage ( "GenJtapiPeer : init Plugin - " + 

plugName, e) ; 

// We don't use the plugin 
continue; 
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} 

runningThreads ++; 
Runnable r = new Runnable ( ) 
{ 

public void run ( ) 
{ 

Hashtable table; 

try 

{ 

table = initPlugin( plugin, resourceFile, initData ); 
m_resources . put ( plugin, table ); 
m_plugins . put ( plugName, plugin ); 
rnjpluginStates . put ( plugin, ms_inService ); 

} 

catch ( Exception e ) 
{ 

// We don't use the plugin 

Gen Jtapi Peer . ms_log . warningMes sage { "Gen Jtapi Peer : init Plugin 

" + plugName, e) ; 

m^resources.put ( plugin, new Hashtable ()) ; 

} 

synchronized ( MultyPlugin JTSMI . this ) 
{ 

MultyPluginJTSMI . this . notify ( ) ; 

} 

} 

}; 

GenJtapiPeer . runlt (r) ; 

} 

while { runningThreads != m_resources . size ( ) ) 
{ 

try { 

wait ( ) ; 

} 

catch ( InterruptedException e ) 
{} 

} 

int level = -1; // 111111111111.... 
pluginsEnum = m_plugins . elements ( ) ; 
while ( pluginsEnum. hasMoreElements ( ) ) 
{ 

level &= (( ProviderPlugin) pluginsEnum. nextElement ( ) ) . prvSupportedLevel ( ) 

} 

m_creator = new JtapiObj ectCreator ( level ); 



public void init ( GenProvider provider) throws InvalidArgumentExcept ion 
{ 

m_provider = provider; 
// Need update callback creator. 
JtapiCallbacks callbacks = 

m_creator . create JtapiCallbacks (provider, this) ; 
Enumeration plugins = m__plugins . elements () ; 
ProviderPlugin plugin; 
while ( plugins . hasMoreElements ( ) .) 
{ 

plugin = ( ProviderPlugin) plugins . nextElement () ; 
plugin . prvSe t Callback (callbacks) ; 
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createEndPoints ( plugin, provider, ( Hashtable ) m_resources . get ( plugin )); 

} 

m_resources = null; 
changeProviderState ( ) ; 



public void updateAddressCapabilit ies ( 

GenAddressCapabilities capabilities ) 

{ 

GenAddressCapabilities tmpCapabilities = new GenAddressCapabilities () ; 

Enumeration plugins = m_plugins . element s () ; 

Provider Plugin plugin; 

if ( plugins . hasMoreElements ( ) ) 

{ 

plugin = (ProviderPlugin) plugins . nextElement () ; 
plugin . updateAddressCapabilities ( capabilities ); 

} 

while ( plugins . hasMoreElements ( ) ) 
{ 

plugin = (ProviderPlugin) plugins . nextElement {) ; 
plugin. updateAddressCapabilities { tmpCapabilities ) ; 
capabilities . and ( tmpCapabilities ); 
tmpCapabilities . reset () ; 

} 



/** 

* Updates <code>static</code> <code>GenTerminalCapabilities</code> for this 

* provider plugin. The <code>GenTerminalCapabilities</code> implements the 

* capability interfaces for the <code>Terminal</code> object from the JTAPI 

* core and all extension packages. By default all methods of instance of the 

* class, except <code>isObservable { ) </code>, return <code>f alse</code> . 

* By this method the plugin can change the default behaved of the instance. 

*/ 

public void updateTerminalCapabilit ies ( 

GenTerminalCapabilities capabilities ) 

{ 

GenTerminalCapabilities tmpCapabilities = new GenTerminalCapabilities () ; 

Enumeration plugins = m_plugins . elements ( ) ; 

ProviderPlugin plugin; 

if ( plugins . hasMoreElements ( ) ) 

{ 

plugin = ( ProviderPlugin) plugins . nextElement () ; 
plugin . updateTerminalCapabilities ( capabilities ); 

} 

- while ( plugins . hasMoreElements ( ) ) 
{ 

plugin = ( ProviderPlugin) plugins . nextElement () ; 
plugin . updateTerminalCapabilities ( tmpCapabilities ); 
capabilities . and ( tmpCapabilities ); 
tmpCapabilities . reset ( ) ; 

} 



/ + * 

* Updates <code>static</code> <code>GenTerminalConnectionCapabilities</code> 



4 



* for this provider plugin. 

* The <code>GenTerminalConnectionCapabilities</code> implements the 

* capability interfaces for the <code>TerminalConnection</code> object from 

* the JTAPI core and all extension packages. By default all methods of 

* instance of the class, except <code>canAnswer ( ) ( ) </code>, return 

* <code>f alse</code> . By this method the plugin can change the default 

* behaved of the instance. 

*/ 

public void updateTerminalConnectionCapabilities ( 

GenTerminalConnectionCapabilities capabilities ) 

{ 

GenTerminalConnectionCapabilities tmpCapabilities = 

new GenTerminalConnectionCapabilities ( ) ; 
Enumeration plugins = m_plugins . elements () ; 
ProviderPlugin plugin; 
if( plugins . hasMoreElements ( } ) 
{ 

plugin = ( ProviderPlugin) plugins . nextElement () ; 

plugin . updateTerminalConnectionCapabilities ( capabilities ); 

> 

while { plugins . hasMoreElements ( ) ) 
{ 

plugin = (ProviderPlugin) plugins . nextElement () ; 

plugin. updateTerminalConnectionCapabilities ( tmpCapabilities ) ; 
capabilities . and ( tmpCapabilities ); 
tmpCapabilities . reset ( ) ; 

} 



* Updates <code>static</code> <code>GenConnect ionCapabilities</code> for 

* this provider plugin. The <code>GenConnect ionCapabilities</code> 

* implements the capability interfaces for the <code>Connection</code> 

* object from the JTAPI core and all extension packages. By default all 

* methods of instance of the class, except <code>canDisconnect () ()</code>, 

* return <code>f alse</code> . By this method the plugin can change the 

* default behaved of the instance. 

*/ 

public void updateConnectionCapabilities ( 

GenConnectionCapabilities capabilities ) 

{ 

GenConnectionCapabilities tmpCapabilities = 

new GenConnectionCapabilities ( ) ; 
Enumeration plugins = m_plugins . elements () ; 
ProviderPlugin plugin; 
if ( plugins . hasMoreElements ( ) ) 
{ 

plugin = (ProviderPlugin) plugins . nextElement () ; 
plugin. updateConnectionCapabilities ( capabilities ); 

} 

while { plugins . hasMoreElements ( ) ) 
{ 

plugin = ( ProviderPlugin) plugins . nextElement () ; 
plugin. updateConnectionCapabilities ( tmpCapabilities ); 
capabilities . and ( tmpCapabilities ); 
tmpCapabilities . reset ( ) ; 

} 
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} 



/ * * 

* Updates <code>static</code> <code>GenACallCapabilities</code> for this 

* provider plugin. The <code>GenCallCapabilities</code> implements the 

* capability interfaces for the <code>Call</code> object from the JTAPI 

* core and all extension packages. By default all methods of instance of the 

* class, except <code>isObservable ( ) </code> and <code>canConnect ( ) </code>, 

* return <code>f alse</code> . By this method the plugin can change the 

* default behaved of the instance. 

*/ 

public void updateCallCapabilities ( GenCallCapabilities capabilities) 
{ 

GenCallCapabilities tmpCapabilities = 

new GenCallCapabilities ( ) ; 
Enumeration plugins = m_plugins . elements () ; 
ProviderPlugin plugin; 
if ( plugins . hasMoreElements ( ) ) 
{ 

plugin = ( ProviderPlugin) plugins . nextElement () ; 
plugin . updateCallCapabilities ( capabilities ); 

} 

while ( plugins . hasMoreElements ( ) ) 
{ 

plugin = ( ProviderPlugin) plugins . nextElement () ; 
plugin . updateCallCapabilities ( tmpCapabilities ); 
capabilities . and ( tmpCapabilities ); 
tmpCapabilities . reset ( ) ; 

} 



/ * * 

* Updates <code>static</code> <code>GenProviderCapabilities^/code> for this 

* provider plugin. The <code>GenProviderCapabilities</code> implements the 

* capability interfaces for the <code>Providers</code> object from the JTAPI 

* core and all extension packages. By default all methods of instance of the 

* class, except <code>isObservable ( ) </code>, return <code>f alse</code> . 

* By this method the plugin can change the default behaved of the instance. 
★ 

*/ 

public void updateProviderCapabilities ( GenProviderCapabilities capabilities) 
{ 

GenProviderCapabilities tmpCapabilities = 

new GenProviderCapabilities ( ) ; 
Enumeration plugins = m_plugins . elements () ; 
ProviderPlugin plugin; 
if ( plugins . hasMoreElements ( ) ) 
{ 

plugin = ( ProviderPlugin) plugins . nextElement () ; 
plugin . updateProviderCapabilities ( capabilities ); 

} 

while { plugins . hasMoreElements ( ) ) 
{ 

plugin = •( ProviderPlugin) plugins . nextElement () ; 
plugin . updateProviderCapabilities ( tmpCapabilities ); 
capabilities . and ( tmpCapabilities ); 
tmpCapabilities . reset ( ) ; 
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} 



public GenAddress getGenAddress ( String addressName ) 

throws InvalidArgumentException 

{ 

addressName = m_j tsmiPlugin . addressConvert ( addressName ); 

GenAddress address = getAddress ( addressName ) ; 

ProviderPlugin plugin; 

Boolean state; 

if( null == address ) 

{ 

String providerPluginName = m_j tsmiPlugin . pluginForAddress ( addressName 

); 

plugin = ( ProviderPlugin) m_plugins . get ( providerPluginName ); 

if ( plugin == null ) 

{ 

throw new Plat f ormException ( 

"MultyPluginJTSMI . getGenAddress : invalid plugin name "); 

} 

state = (Boolean) m_pluginStates . get ( plugin); 

if ( ! state . booleanValue ( ) ) 

{ 

throw new Platf ormException ( " The provider plugin is out of 

service" ) ; 

r 

address = m_creator . createRemoteAddress (m_provider , plugin, addressName); 

} 

else 
{ 

plugin = address . get ProviderPlugin () ; 

state = (Boolean) m_pluginStates . get ( plugin); 

if ( ! state . booleanValue ( ) ) 

{ " 
throw new Plat f ormException ( " The provider plugin is out of 

service" ) ; 

} 

} 

return address; 



public GenAddress getAddress ( String addressName ) 

throws InvalidArgumentException 

{ 

addressName = m_j tsmiPlugin . addressConvert ( addressName ); 

if ( addressName == null ) 

{ 

throw new InvalidArgumentException ( "null address number" ); 

} 

return (GenAddress ) m__addr esses . get ( addressName ); 



public GenTerminal getGenTerminal ( String terminalName ) 

throws InvalidArgumentException 

{ 

GenTerminal terminal = getTerminal ( terminalName ) ; 
/* if( null == terminal ) 
{ 
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terminal = m_creator . createRemoteTerminal (m_provider , m_plugin, 

terminalName) ; 

} */ 

return terminal; 

} 

public synchronized void inService (boolean state, ProviderPlugin plugin) 

throws IllegalStateException, IllegalArgumentException 

< 

if ( null == plugin ) 
{ 

throw new IllegalArgumentException ( " null plugin object " ); 

} 

Boolean newState = ( state ) ? ms_inService : ms_outOf Service ; 
Boolean oldState = (Boolean) m_pluginStates . get (plugin) ; 
if( ! newState . equals (oldState) ) 
{ 

m_pluginStates . put ( plugin, newState ); 
changeProviderState ( ) ; 

} 

if( ! state ) 
{ 

try 
{ 

Call[] calls = m_provider . getCalls ( ) ; 

if( calls != null) 

{ 

f or ( int i=0; i<calls . length; i++) 
{ 

GenConnection [ ] conn = 

(GenConnection [ ] ) calls [ i] . get Connect ions ( ) ; 
f or ( int j=0; j< conn. length; j++) 
{ 

if ( conn [j ] . getProviderPlugin ( ) . equals (plugin) ) 
{ 

conn [ j ] . disconnect ( ) ; 

} 

} 

} 

} 

} 

catch ( Exception e) 
{ 

GenJtapiPeer .ms_log . errorMessage ( 

"MultyPluginJTSMI . inService " , e) ; 

} 

} 

} 

private void changeProviderState ( ) 
{ 

Hashtable table — new Hashtable ( m_plugins.size() ); 
Enumeration plugNames = m_plugins . keys ( ) ; 
String pluginName; 

while ( plugNames . hasMoreElements ( ) ) 
{ 

pluginName = ( String) plugNames . nextElement () ; 
table. put ( pluginName, 

m_pluginStates . get ( m_plugins . get (pluginName) ) ) ; 
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} 

int state = m_provider . getState ( ) ; 

//we cannot change the SHUTDOWN state of provider. 

if( m_jtsmiPlugin . isInService ( table )) 

{ 

if( state == Provider. OUT_OF_SERVICE ) 
{ 

m_provider . moveToState.( Provider . IN_SERVICE ); 

} 

} 

else 
{ 

if( state == Provider . IN_SERVICE ) 
{ 

m_provider .moveToState ( Provider . OUT_OF_SERVICE ) 

} 

} 

} 

public boolean isPluginlnService ( ProviderPlugin plugin) 
{ 

Boolean state = (Boolean) m_pluginStates . get (plugin) ; 

if ( state != null ) 

{ 

return state .booleanValue () ; 

} 

return false; 

} 
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package com. ibm. hrl . jtapi . j tspi; 
/* 

* (c) Copyright IBM Corporation 1998,1999 

* IBM Research Laboratory in Haifa 

* Generic JTAPI Implementation (JTAPI 1.2) 

* 

* Package : com. ibm. hrl . jtapi . j tspi 

* Abstract class : Provider Pl ugin 

* Created : ^^^ ^IjS^ 
*/ 

import java . util . Hashtable; 
import j ava . util . Properties ; 

import com. ibm. hrl . jtapi . GenProvider; 
j * * 

* Defines methods of provider-specific services for the core package. 

* <p> 

* The provider-specific implementation of the interface should be registered 

* in the service configuration file. 
* 

* The JTSPI implementor is not requered to know the GenJTAPI implimentation . 
* 

* @see com. ibm. hrl . j tapi . Gen JtapiPeer#get Provider 

* @see com. ibm. hrl . j tapi . GenProvider 

* @see com. ibm. hrl . j tapi . GenProvider#initPlugins 

* @author Alexey Roytman 
*/ 

public abstract class ProviderPlugin { 
// IBM Copyright 

public static final String IBM_Copyright = Copyright . SHORT_STRING; 

/* * 

* The plugin supports the Call Control JTAPI extension. 
*/ 

public static final int CALLCONTROL_LEVEL = 0x01; 
f * * 

* The plugin supports the Call Center JTAPI extension. 
*/ 

public static final int CALLCENTER_LEVEL = 0x02; 
/ * * 

* The plugin supperts the Media package JTAPI 1.2 extension. 
*/ 

public static final int MEDIA_12_LEVEL = 0x04; 

/ * * 

* The plugin supperts the Media package JTAPI 1.3 extension. 
*/ 

public static final int MEDIA_LEVEL = 0x08; 

/ * * 

* The plugin supperts the Phone package JTAPI extension. 
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*/ 

public static final int PHONE_LEVEL = 0x10; 

/ * * 

* The plugin supperts the Private date package JTAPI extension. 
*/ 

public static final int PRI VAT E_DAT A_LE VEL = 0x20; 
I ± + 

* The plugin supports the Mobile package JTAPI extension. 
*/ 

public static final int MOBILE_LEVEL = 0x4 0; 

f * * 

* Reference to the JtapiCallbacks object. The plugin can inform 

* GenJTAPI about asynchronously events by the JtapiCallbacks 1 s methods. 
*/ 

protected JtapiCallbacks m_callback; 
/* * 

* Default constructor. 

* We need it for dynamic instantiation. 

* We cannot use not default constructor for dynamic instantiation in the J2ME 

* environment. 
*/ 

public ProviderPlugin ( ) {} 
/* * 

■ * Constructs the <code>ProviderPlugin</code> object and sets the reference 

* to the <code> JtapiCallbacks</code> object. 

* @param provider The given reference to the <code> JtapiCallbacks</code> 

* object. 
* 

* @see com. ibm . hrl . j tapi . j tspi . JtapiCallbacks 
*/ 

public ProviderPlugin ( JtapiCallbacks callback ) { 
m_callback = callback; 

} 

/** 

* Returns attached <code> JtapiCallbacks</code> object. 

* ©return reference of the <code>JtapiCallbacks</code> 

* object. 
*/ 

public final JtapiCallbacks prvGetCallbacksRef ( ) { 
return m_callback; 

} 

/ * ★ 

* Sets the reference to the <code> JtapiCallbacks</code> object. 
* 

* Qparam provider The given reference to the 

* <code>JtapiCallbacks</code> object. 
*/ 

public void prvSetCallback ( JtapiCallbacks callback ) { 
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// We cannot use not default constructor for dynamic instantiation 
// in the J2ME 
m_callback = callback; 
} 

I + * 

* The Generic JTAPI implementation needs to know which JTAPI extension 

* packages are supported by the plugin. The method returns a bit mask of 

* the supported levels. By default the method returns only Core supported 

* level. The ProviderPlugin extensions should overwrite the method, for 

* returning the right supported levels. 
* 

* ©return the bit mask of the <code>ProviderPlugin</code> supported JTAPI 

* extension. 
*/ 

public int prvSupportedLevel { ) { 
return 0; 

} 

f * •* 

* The method initialize the implementation specific plugin. 

* It use a given table of provider's domain of local addresses and 

* their terminals, associated with this plugin, as well as a 

* given application arguments. 

* <br> The localAddresses argument is <code>Hashtable</code> of 

* the provider-plugin 1 s domain of local addresses and their associated 

* terminals. The keys are names of the addresses and the values are 

* arrays of assosiated terminals' names. 

* <br> The arg is <code>Property</code> with the plugin specific 

* configuration data. This data creates from union of configuration 

* data from the plugin resource file and the optional data 

* specified in the initialization string when JtapiPeer . get Provider ( ) 

* is called. If the same property defined in the resource file and in the 

* initialization string the value from the initialization string is 

* preferable . 

* <br>This. method is called by the <code>GenProvider</code> object 

* during plugins initialization. 
+ 

* ©param localAddresses <code>Hashtable</code> with the given 

* provider-plugin ' s domain of local addresses and their associated 

* terminals. 
* 

*. ©param arg The <code>Property</code> union of arguments specified by the 

* application (the provider specific initialization arguments) and the 

* data from the plugin resource file. 
* 

* ©exception IllegalArgumentException if a <code>null</code> argument is 

* passed. 

* ©exception com. ibm . hrl . j tapi . j tspi . Jt spiException if a platform-specific 

* exception occurred. 

'* ©exception IllegalStateException if the current state of an object 

* involved in this method doesn't meet the acceptable conditions. 
* 

* ©see com. ibm. hrl . j tapi . GenJtapiPeer#getProvider 

* ©see com. ibm. hrl . j tapi . GenProvider#init Plugins 
*/ 

public abstract void prvlnitiali ze ( Hashtable localAddresses, Properties arg ) 
throws IllegalArgumentException, JtspiException, IllegalStateException; 
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/* * 

* Instructs the plugin to shut itself down and perform all necessary 

* cleanup. This method is intended to allow the plugin to perform any 

* necessary cleanup. 
* 

* ©exception <code>com . ibm . hrl . j tapi . j tspi . Jt spiException</code> if a 

* platform-specific exception occurred. 

* ©exception <code>IllegalStateException</code> if the current state 

* of an object involved in this method doesn f t meet the acceptable 

* conditions. 
*/ 

public abstract void prvShutdown ( ) throws JtspiExcept ion, 
IllegalStateException; 

/** 

* This method should establish real connection to a given local endpoint 

* for a call, associated with a given callld. 

* @param callld The ID of the given <code>Call</code> object. 

* ©param localAddr The given local <code>Address</code> object name. 

* ©param localTerm The given local <code>Terminal</code> object name. ■ 
* 

* ©exception <code>IllegalArgumentException</code> if a 

* <code>null</code> argument is passed or there is no association 

* between the given objects. 

* ©exception <code>com. ibm. hrl . j tapi . j tspi . JtspiException</code> if 

* a platform-specific exception occurred. 

* ©exception <code>IllegalStateException</code> if the current state 

* of an object involved in this method doesn't meet the acceptable 

* conditions. 
*/ 

public abstract void prvConnectLocal ( String callld, String localAddr, 
String localTerm ) throws IllegalArgumentException, Jt spiException, 

IllegalStateException; 

/ * + 

* This method should establish real connection to a given remote endpoint 

* for a call, associated with a given callld. 
* 

* ©param callld The ID of the given <code>Call</code> object. 

* ©param localAddr The given remote <code>Address</code> object name. 

* ©param localTerm The given remote <code>Terminal</code> object name. 
+ 

* ©exception <code>IllegalArgumentExcept ion</code> if a 

* <code>null</code> argument is passed or there is no association 

* between the given objects. 

* ©exception <code>com . ibm . hrl . j tapi . j tspi . JtspiException</code> if 

* a platform-specific exception occurred. 

* ©exception <code>IllegalStateException</code> if the current state 

* of an object involved in this method doesn't meet the acceptable 

* conditions. 
*/ 

public abstract void prvConnectRemote ( String callld, String partyAddr ) 
throws IllegalArgumentException, Jt spiException, IllegalStateException; 

/ * * 

* This method should notify the plugin that the given 

* incoming call, associated with a given callld has been answered. 
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* 

* ©param callld The ID of the given <code>Call</code> object. 

* ©param localAddr The given local <code>Address</code> object name. 

* ©param localTerm The given local <code>Terminal</code> object name. 

* ©param remoteAddr The given originating <code>Address</code> object name. 

* ©param remoteTerm The given originating <code>Terminal</code> object name 
* 

* ©exception <code>IllegalArgumentException</code> if a 

* <code>null</code> argument is passed or there is no association 

* between the given objects. 

* ©exception <code>com. ibm. hrl . j tapi . j tspi . JtspiException</code> if 

* a platform-specific exception occurred. 

* ©exception <code>IllegalStateException</code> if the current state 

* of an object involved in this method doesn't meet the acceptable 

* conditions. 
*/ 

public abstract void prvAnswer { String callld, String localAddr, 
String localTerm, String remoteAddr, String remoteTerm ) 

throws I llegalArgument Except ion, JtspiException, IllegalStateException 

/ * * 

* This "method should terminate connection, associated with a given callld- 

* and given local party object. 

* This method also should notify the remote party of terminated connection. 
* 

* ©param callld The ID of the given <code>Call</code> object. 

* ©param localAddr The given local <code>Address</code> object name. 

* ©param localTerm The given local <code>Terminal</code> object name. 
* 

* ©exception <code>IllegalArgumentException</code> if a 

* <code>null</code> argument is passed or there is no association 

* between the given objects. 

* ©exception <code>com. ibm. hrl . j tapi . j tspi. JtspiException</code> if 

* a platform-specific exception occurred. 

* ©exception <code>IllegalStateException</code> if the current state 

* of an object involved in this method doesn't meet the acceptable 

* conditions. 
*/ 

public abstract void prvDisconnectLocal ( String callld, String localAddr, 
String localTerm ) throws IllegalArgumentException, JtspiException, 
IllegalStateException; 

/* * 

* This method should terminate the remote connection to a given call 

* party's object. 

* 

* ©param callld The ID of the given <code>Call</code> object. 

* ©param partyAddr The given call party's <code>Address</code> object name. 

* ©param partyTerm The given call party's <code>Terminal</code> object name 
* 

* ©exception <code>IllegalArgumentException</code> if a 
*.<code>null</code> argument is passed or there is no association 

* between the given objects. 

* ©exception <code>com. ibm. hrl . j tapi . j tspi . JtspiException</code> if 

* a platform-specific exception occurred. 

* ©exception <code>IllegalStateException</code> if the current state 

* of an object involved in this method doesn't meet the acceptable 

* conditions. 
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public abstract void prvDisconnectRemote ( String callld, String partyAddr, 
String partyTerm ) throws IllegalArgumentException, JtspiExcept ion, 
IllegalStateException; 

j * * 

* Updates <code>static</code> <code>GenAddressCapabilities</code> for this 

* provider plugin. The <code>GenAddressCapabilities</code> implements the 

* capability interfaces for the <code>Address</code> object from the JTAPI 

* core and all extension packages. By default all methods of instance of the 

* class, except <code>isObservable ( ) </code>, return <code>f alse</code> . 

* By this method the plugin can change the default behaved of the instance. 

*/ 

public void updateAddressCapabilities ( 

UpdateableAddressCapabilities capabilities) {} 

/** 

* Updates <code>static</code> <code>GenTerminalCapabilities</code> for this 

* provider plugin. The <code>GenTerminalCapabilit ies</code> implements the 

* capability interfaces for the <code>Terminal</code> object from the JTAPI 

* core and all extension packages. By default all methods of instance of the 

* class, except <code>isObservable ( ) </code>, return <code>f alse</code> . 

* By this method the plugin can change the default behaved of the instance. 

*/ 

public void updateTerminalCapabilities ( 

UpdateableTerminalCapabilities capabilities) {} 

/** 

* Updates <code>static</code> <code>GenTerminalConnectionCapabilities</code> 

* for this provider plugin. 

* The <code>GenTerminalConnectionCapabilities</code> implements the 

* capability interfaces for the <code>TerminalConnection</code> object from 

* the JTAPI core and all extension packages. By default all methods of 

* instance of the class, except <code>canAnswer ( ) ()</code>, return 

* <code>f alse</code> . By this method the plugin can change the default 

* behaved of the instance. 

*/ 

public void updateTerminalConnect ionCapabilities ( 

UpdateableTerminalConnectionCapabilities capabilities) { } 

/ * * 

* Updates <code>static</code> <code>GenConnectionCapabilities</code> for 

* this provider plugin. The <code>GenConnectionCapabilities</code> 

* implements the capability interfaces for the <code>Connection</code> 

* object from the JTAPI core and all extension packages. By default all 

* methods of instance of the class, except <code>canDisconnect ( ) ()</code>, 

* return <code>f alse</code> . By this method the plugin can change the 

* default behaved of the instance. 

*/ 

public void updateConnectionCapabilit ies ( 

UpdateableConnectionCapabilities capabilities) { } 

/* * 

* Updates <code>static</code> <code>GenACallCapabilities</code> for this 

* provider plugin. The <code>GenCallCapabilities</code> implements the 

* capability interfaces for the <code>Call</code> object from the JTAPI 
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* core and all extension packages . By default all methods of instance of the 

* class, except <code>isObservable ( ) </code> and <code>canConnect ( ) </code>, 

* return <code>f alse</code> . By this method the plugin can change the 

* default behaved of the instance. 

*/ 

public void updateCallCapabilities ( 

UpdateableCallCapabilities capabilities) { } 

* Updates <code>static</code> <code>GenProviderCapabilities</code> for this 

* provider plugin. The <code>GenProviderCapabilities</code> implements the 

* capability interfaces for the <code>Providers</code> object from the JTAPI 

* core and all extension packages. By default all methods of instance of the 

* class, except <code>isObservable ( ) </code>, return <code>f alse</code> . 

* By this method the plugin can change the default behaved of the instance. 

*/ 

public void updateProviderCapabilities ( 

UpdateableProviderCapabilities capabilities) {} 



7 



package com. ibm. hrl . j tapi . j tspi; 



/* 

* (c) Copyright IBM Corporation 1998,1999,2000 

* IBM Research Laboratory in Haifa 

* Generic JTAPI Implementation (JTAPI 1.3) 
★ 

* Package : com. ibm. hrl . j tapi 

* Interface : HybridProv iderPlugin 

* Created : J T j 7W .^ r ' r T^^ 

*/ 

public interface HybridProviderPlugin 
{ 

// IBM Copyright 

public static final String IBM_Copyright = Copyright . SHORT_STRING; 



/ * * 

* Informs the plugin that a given destination (remote) party has 

* answered the call. 

* ©param callld The ID of the given <code>Call</code> object. 

* @param remoteAddr The given remote <code>Address</code> object name. 

* ©param remoteTerm The given remote <code>Terminal</code> object name. 
* 

* ©exception IllegalArgumentException if a <code>null</code> argument 

* is passed. 

* ©exception IllegalStateException if the current state of an object 

* involved in this method doesn't 

* meet the acceptable conditions. 

* ©exception JtspiException if a platform-specific exception occurred. 
*/ 

public void prvConnected (String callld, String remoteAddr, String remoteTerm) 
throws IllegalArgumentException, IllegalStateException, 
JtspiException; 

/* * 

* Informs the plugin that a remote party has disconnected from a 

* <code>Call</code> associated with the given callld. 

* @param callld The ID of the given <b>Call</b> object. 

* ©param remoteAddr The given remote <b>Address</b> object name. 

* ©param remoteTerm The given remote <b>Terminal</b> object name. 
★ 

* ©exception IllegalArgumentException if a • <code>null</code> argument 

* is passed. 

* ©exception IllegalStateException if the current state of an object 

* involved in this method doesn't 

* meet the acceptable conditions. 

* ©exception JtspiException if a platform-specific exception occurred. 
*/ 

public void prvDisconnected (String callld, String remoteAddr, String remoteTerm) 
throws IllegalArgumentException, IllegalStateException, 
JtspiException; 

/ ★ + 

* Tells the Generic JTAPI that the connection associated with the 
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* given callld and the party's objects has failed. 
* 

* ©param callld The ID of the given <b>Call</b> object. 

* @param partyAddr The given party <b>Address</b> object name. 

* ©param partyTerm The given party <b>Terminal</b> object name. 

* @param cause- The cause of the failure. 
* 

* ©exception IllegalArgumentException if a <code>null</code> argument 

* is passed. 

* ©exception IllegalStateException if the current state of an object 

* involved in this method doesn't 

* meet the acceptable conditions. 

* ©exception JtspiException if a platform-specific exception occurred. 
*/ 

public void prvFailed (String callld, String partyAddr, 

String partyTerm, int cause) 
throws IllegalArgumentException, IllegalStateException, 
JtspiException; 

/ * * 

* Tells the Generic JTAPI that the connection is ringing at the 

* remote party's terminal. 
* 

* ©param callld The ID of the given <b>Call</b> object. 

* @param remoteAddr The given remote <b>Address</b> object name. 

* @param remoteTerm The given remote <b>Terminal</b> object name. 
* 

* ©exception IllegalArgumentException if a <code>null</code> argument 

* is passed. 

* ©exception IllegalStateException if the current state of an object 

* involved in this method doesn't 

* meet the acceptable conditions. 

* ©exception JtspiException if a platform-specific exception occurred. 
*/ 

public void prvRinging (String callld, String remoteAddr, String remoteTerm) 
throws IllegalArgumentException, IllegalStateException, 
JtspiException; 

/** 

. * Tells the Generic JTAPI that there is a new party was added to the 

* <code>Call</code>. 

* ©param callld The ID of the given <code>Call</code> object. 

* ©param newAddr The <code>Address</code> object name of the new party. 

* ©param newTerm The <code>Terminal</code> object name of the new party. 

* ©param plugin The reference to the calling provider plugin. 
* 

* ©exception IllegalArgumentException if a <code>null</code> argument 

* is passed. 

* ©exception IllegalStateException if the current state of an object 

* involved in this method doesn't 

* b .meet the acceptable conditions. 

* ©exception JtspiException if a platform-specific exception occurred. 
*/ 

public void prvPartyAdded ( String callld, String newAddr, String newTerm ) 
throws IllegalArgumentException, IllegalStateException, 
JtspiException; 
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/** 

* Tells the Generic JTAPI that the two <code>Call</code> objects were 

* merged. 

* <p> 

* If the both <code>Call</code> objects belong to this 

* Generic JTAPI, the Generic JTAPI merges the corresponding objects and 

* the method returns <code>true</code> . 

* <p> 

* If only call with first ID belong to this Generic JTAPI, the method 

* returns <code>f alse</code>, and the Generic JTAPI will expect to the 

* states updating by <code>partyAdded</code> method. 

* <p> 

* If only call with second ID belong to this Generic JTAPI, the ID of the 

* call will be changed, the method returns <code>f alse</code> and the 

* Generic JTAPI will expect to the states updating by 

* <code>partyAdded</code> method. 

* <p> 

* If the both calls are not associated with this Generic JTAPI, nothing 

* will be done and the method returns <code>f alse</code> 

* <p> 

* @param targetld The Id of the stayed <code>Call</code> object. 

* @param sourceld The name of the swallowed up <code>Call</code> object. 

* @return <code>true</code> . if the state changing was finished. 

* ©exception IllegalArgumentException if a <code>null</code> argument 

* is passed. 

* ©exception IllegalStateException if the associated <code>Call</code> 

* objects is not in the ACTIVE state. 

* ©exception JtspiException if a platform-specific exception occurred. 
*/ 

public boolean prvCallsMerged ( String targetld, String sourceld) 

throws IllegalArgumentException, IllegalStateException, 
JtspiException; 

* Tells the Generic JTAPI that the <code>Connection</code> associated with 

* a given Calild and <code>Address</code> was redirected to a new 

* destination <code>Address</code> . 
* 

* ©param calild The given <code>Call</code> object ID. 

* ©param oldAddr The name of the current <code>Address</code> object. 

* ©param newAddr The name of the given new destination 

* <code>Address</code> object. 
* 

* ©exception IllegalArgumentException if a <code>null</code> argument 

* is passed or there is no association 

* between given call party objects. 

* ©exception IllegalStateException if the current state of an object 

* involved in this method doesn't meet 

* the acceptable conditions. 

* ©exception JtspiException if a platform-specific exception occurred. 

*/ 

public void prvRedirected ( String calild, String oldAddr, 

String newAddr) 
throws IllegalArgumentException, IllegalStateException, 
JtspiException; 

f ★ * 
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* Tells the Generic JTAPI that the <code>Call</code> object was transferee! 

* <p> 

* ©param callld The Id of the <code>Call</code> object. 

* ©param address The name of the <code>Address</code> associated with the 

* transfer controller <code>TerminalConnection</code> . 

* ©param terminal The name of the <code>Terminal</code> associated with the 

* transfer controller <code>TerminalConnection</code> . 

* ©param newAddr The name of the given new destination 

* <code>Address</code> object. 
* 

* ©exception IllegalArgumentExcept ion if a <code>null</code> argument 

* is passed. 

* ©exception IllegalStateException if the associated <code>Call</code> 

* objects is not in the ACTIVE state. 

* ©exception JtspiException if a platform-specific exception occurred. 
*/ 

public void prvTransf ered ( String callld, String address, 

String terminal, String newAddress) 
throws IllegalArgumentException, IllegalStateException, 
JtspiException; 

I -k * 

* Tells the <code>Provider</code> object that one or more DTMF digits 

* have been detected. 
★ 

* @param _callld The ID of the given <b>Call</code> object. 

* @param ^address The name of the given <code>Address</code> object. 

* ©param ^terminal The name of the given <code>Terminal</code> object. 

* @param _digits The Dtmf digits that were detected. 
* 

* ©exception IllegalArgumentException if a <code>null</code> argument is 

* passed. 

* ©exception IllegalStateException if the current state of an object 

* involved in this method doesn't meet the 

* acceptable conditions. 

* ©exception JtspiException if a platform-specific exception occurred. 
*/ 

public void prvDtmf Detected ( String _callld, String _address, String _terminal, 

String _digits) 
throws IllegalArgumentException, IllegalStateException, 
JtspiException; 

/* * 

* Tells the <code>Provider</code> object that the availability of the 

* media for a <code>TerminalConnection</code> has changed. 

* ©param _callld The ID of the given <b>Call</code> object. 

* ©param _address The name of the given <code>Address</code> object. 

* ©param _terminal The name of the given <code>Terminal</code> object. 

* ©param _available <code>true</code> if media is available, otherwise - 

* <code>f alse</code> . 
* 

* ©exception IllegalArgumentException if a <code>null</code> argument is 

* passed. 

* ©exception IllegalStateException if the current state of an object 

* involved in this method doesn't meet the 

* acceptable conditions. 
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* ^exception JtspiException if a platform-specific exception occurred. 
*/ 

public void prvSetMediaAvailability (String _callld, String _address, 

String ^terminal, boolean ^available) 
throws I llegalArgument Except ion, IllegalStateException, 
JtspiException; 
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ANNEX C 



To: Asser Tantawi/Watson/IBM@IBMUS, Jurij R Paraszczak/Watson/IBM@IBMUS, 
Andreas Strebel/Zurich/IBM@IBMCH, Tirtsa Hochberg/Haifa/IBM@IBMIL, 
Samuel Kallner/Haifa/IBM@IBMIL, Lucas S Heusler/Zurich/IBM@IBMCH, 
Yann Duponchel/Zurich/IBM@IBMCH, Marcel Graf/Zurich/IBM@IBMCH, Linda 
Steinmuller/Fort Lauderdale/IBM@IBMUS 

cc: Oded Cohn 

From: Pnina Vortman/Haifa/IBM@IBMIL 
Subject: Sonera Visit - Foak Status 



Hi Everyone, 

I would like to report to all of you, those that witnessed the meeting as 
well as the others on the results and the great success of the deployment 
of the whole system in Sonera. 

The experience was amazing. The system that we delivered was composed of 
components from Haifa, Zurich and Watson. It was integrated by Shmuel who 
did an outstanding work. 
The components included were: 
-SEE - Service Execution Environment from ZRL 
-NaSS - Notification and Synchronisation server from ZRL 
-GenJTAPI with JTAPI simulator from HRL 
-Service Creation (Service Packaging) from WRL 
-Service Provisioning and Subscription from HRL 
-Service Management demo from HRL 

The complete system was deployed and part of the management tasks were 
deployed on WebSphere that was installed in Sonera. 
With some minor problems, unrelated to our own delivery, things worked like 
a charm after 2 hours. 

Note: the main problem was related to WebSphere and was caused as a result 
of one of the Sonera people renaming the Java JDK1.1.7 which is required by 
WebSphere. 

What was even more amazing was the fact, the once the system was installed 

and working using the JTAPI simulator, it was replaced by the JTSPI 

implementation Sonera team implemented for their OSN switch. Without any 

problem at all, things work immediately and phones started to ring. The 

follow me service was working without a problem. 

This was real impressive as it proved many things. It is really rare that 

so many components that are integrated from different sources including one 

from Sonera work on first coup. 

The NaSS, handled the hot provisioing immediately, and proved the 
advantages of the technology. The Subscription was using the new XML 
technology and the NaSS was notified and delivered the information to the 
SEE which executed the services with the new information immediately. It 
was all working with the phones. 

I would like to say Kudos to the team that did excellent work and could 
also show that they could overcome many difficulties and get a project as 
complex as this one working. 

Moreover, this was a real research project and results and conclusions will 
be reported separately. There will be several important invention 
disclosures as well as papers resulted of this work. 

In the meantime, we shall complete our work that was left until August and 
will start fresh. 

Thanks to you all and to Jurij for his leadership and persistent, 

I am sorry he did not have the chance to hear the phones ringing, but it 

was 



Pnina Vortman 

Muiti-Media Networking Applications, Manager 
Haifa Research Lab 

Tel: 972-4-8296339 Fax: 972-4-8550070 



